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This manual provides detailed information on catalog 
management routines. These routines record 
identification of volumes used by data sets by 
maintaining information in logical records called 
indexes. The functions and structures of the routines 
are described, as are their relationships to other 
portions of IBM System/360 Operating System, This 
manual also describes the structure of catalog data 
sets that contain the indexes processed by catalog 
management routines. It is intended for use by persons 
involved in program maintenance, and system programmers 
who are altering the program design. Program logic 
information is not necessary for the use and operation 
of the program; therefore, distribution of this 
publication is limited to those with the aforementioned 
requirements. 
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PREFACE 



This publication provides customer 
engineers and other technical personnel 
with information describing the internal 
organization and logic of the catalog 
management routines. Publications that 
contain external information about the 
catalog and its use are: 

IBM System/ 3 60 Operating t^^t^ m: 
Supervisor and Data Management ^Services , 
Form C28-6646 

IBM Svstem/36Q Operating System 

System Programmer's Guide , Form C28-6550 

Some publications describing other 
aspects of the Operating System are 
referred to in the text. These are: 

IBM System/3 60 Operating System 
Direct Access Device Space Management , 
Form Y28-6607 

IBM System/36 Operating System 
Seguential Access Methods , Form Y28-6604 

This manual is divided into eight major 
sections with three appendixes. 

The Introduction describes the catalog 
management routines and the catalog as they 
relate to the rest of the Operating System. 

The Catalog Data Set section describes 
the structure and organization of the 
catalog data set. An understanding of this 
data set is a prerequisite for an 
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understanding of the routines used to 
access and modify it. 



The Method of Operation section 
describes the logical functions of the 
catalog management routines. 

Tne Program Organization section 
describes each module of the routines in 
detail, with particular emphasis on the 
differences between the actual code 
involved and the logical functions of the 
routines. 

The Directory is a chart that enables 
the reader to find a section of code, a 
flowchart, or a text reference, given any 
one of the three. 

The Data Area Layouts section describes 
in detail each of the catalog entries and 
also the user's parameter list. 

The Diagnostic Aids section contains 
charts of register usage at various stages 
in catalog processing and of the factors 
involved in determining which module gets 
control when. 

The three appendixes contain detailed 
flowcharts, a diagram of the device type 
field found in data set pointer entries and 
CVOL pointer entries, and a description of 
a CVOL pointer entry which is no longer 
created by catalog but which may still 
exist in some installations. 
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This publication corresponds to Release 18- It is a major 
revision of, and obsoletes, Y28-6606-0 and Technical 
Newsletters Y26-8013 and Y26-8020. 

This revision is a complete rewrite of the original 
publication. The organization has been completely revised, 
the text has been rewritten, and most of the figures have 
been changed. This edition also reflects the addition of a 
new module, IGG0CLC6, to the catalog management routines. 
This module performs some of the functions previously 
performed by IGG0CLC2. 

Specifications contained herein are subject to change from 
time to time. Any such change will be reported in subsequent 
revisions or technical newsletters. 

This publication was prepared for production using an IBM 
computer to update the text and to control the page and line 
format. Page impressions for photo-offset printing were 
obtained from an IBM 1403 Printer using a special print 
chain. 

Requests for copies of IBM publications should be made to 
your IBM representative or to the IBM branch office serving 
your locality. 

A form is provided at the back of this publication for 
reader's comments, if the form has been removed, comments 
may be addressed to IBM Corporation, Programming 
Publications, Department D78, San Jose, California, 95114. 
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INTRODUCTION 



Catalog management is the facility of 
the Operating System for locating data sets 
when the user specifies only the data set 
names. The catalog, itself a data set 
(DSNAME=SYSCTLG) , contains data set names 
correlated with volume and device type 
information. The catalog management 
routines supervise the organization of the 
catalog, insert, remove, and locate entries 
in the catalog, and format new catalogs and 
partitioned data set directories. 



set may be referred to by its absolute name 
(e.g., A.B.C.G0006V00) for any catalog 
functions, or by a relative generation 
number (e.g., a.B.C(-2) ) for the locate 
function. The catalog management routines 
keep only the specified number of entries 
in the generation index (index 'C in this 
case) , deleting older ones and adding new 
ones when necessary, and emptying the index 
and deleting the data sets themselves if 
the user specified the EMPTY or DELETE 
options when he created the generation 
index. 



QRGAl>IIZATIQN by level of QUALIFICATION 



Operating System data set names may be 
either simple or qualified . A simple name 
is a collection of up to eight EBCDIC 
characters- A qualified name is a 
collection of simple names separated by 
periods ( . ) with a total length of up to 
44 bytes. 

Catalog management uses the periods in a 
qualified name as delimiters and uses the 
simple names (called qualifiers) as index 
names. The catalog is divided into 
indexes, each of which represents one level 
of qualification of a qualified name. 
Since the catalog management routines can 
ouild or update only one index at a time, 
all levels of a data set name except the 
lowest one must exist before the data set 
can oe cataloged or before a new index can 
be built. If the user wishes to catalog a 
data set called A.B.C, for example, he 
would have to create index A first, then 
index A.B, and then he would have to 
catalog data set A.B.C. 

The highest level index, called the 
volume index, is Duilt automatically the 
first time a new catalog is used by the 
catalog management routines. 



GENERATION DATA GROUP STRUCUTURE 



The same structure is used to maintain 
generation data groups. A generation data 



For a description of the use of 
generation data groups, see IBM System/ 360 
operating System Supervisor and Data 
Management Services , C28-6646. 



CONTROL VOLUMES 



Any direct access volume may contain a 
catalog; any such volume is called a 
control volume (CVOL) . The system 
residence volume always contains a catalog. 



An item in the catalog of a CVOL other 
than tne system residence volume can be 
made available to the system if the CVOL is 
*• connected" to the system residence volume. 
To connect a CVOL to the system residence 
volume, the catalog management routines 
insert a control volume pointer entry into 
the volume index of the catalog on the 
system residence volume. This entry 
contains, in its name field, the name of a 
high level index which already exists on 
the CVOL to be connected. (See Figure 1.) 

Any search of the catalog always starts 
on the system residence volume, but if the 
catalog management routines encounter a 
control volume pointer entry attached to 
the highest level of the name in the volume 
index, they continue the search for the 
fully-qualified name on the specified CVOL. 
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Figure 1. A Control Volume Connected to the System Residence Volume 



CALLING THE CATALOG MANAGEMENT ROUTINES 



Tne catalog management routines are 
accessed through three assembler language 
macro instructions: LOCATE, INDEX, and 
CATALOG. The macro instructions generate a 
reference to a parameter list, which the 
user must build, and an SVC 26 instruction. 
The user's parameter list contains a group 
of flags that indicate what function he is 
asking the catalog management routines to 
perform. Figure 2 summarizes these 
functions, and the section "Data Area 
Layouts" contains a detailed description of 
the user's parameter list. 



The catalog management macro 
instructions are most commonly used by the 
utility lEHPROGM and the job scheduler, 
although they may be employed Dy any user 
of assembler language. lEHPROGM creates 
and deletes indexes, aliases, and 
generation indexes, and catalogs and 
uncatalogs data sets according to 
specifications supplied by tne user of 
lEHPROGM. The job scheduler calls the 
catalog management routines when it must 
locate a data set, given only its name, or 
when the DISP parameter on a DD card is 
CATLG or UNCATLG. 



FUNCTION 



LOCATE a data set by name 

a block in the catalog by TTR 



BUILD a normal index 

a generation index 

an alias to a high-level index 



ABBREVIATION* 



NAME 
BLOCK 



BLDX 
BLDG 
BLDA 



-H 



DELETE 



an index 
an alias 



DLTX 
DLTA 



CONNECT two control volumes 



LINKX 



-H 



DISCONNECT two control volumes 



DRPX 



CATALOG 



a data set 



CATALOG 



-H 



UNCATALOG a data set 



h- 



UNCAT 



RECATALOG a data set (change the volume 

serial number associated with an 
already cataloged data set) 



RECAT 



-H 



♦The abbreviations here are used in the comments of the 
source code to indicate what operation the user requested 



Figure 2. Functions of the Catalog Management Routines 
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CATALOG DATA SEX 



Physically, a catalog is arranged in 
blocks with keys. Logically, it is 
arranged in index levels. This section 
will describe the catalog's physical 
organization briefly and its logical 
organization in detail. 



See Figure 3 for an illustration of a 
typical block in the catalog. 



PHYSICAL BLOCKS 



INDEX LEVELS 



The physical organization of the catalog 
is identical with that of a partitioned 
data set directory. 

A catalog data set is formatted into 
256-byte blocks with 8-byte keys. Each 
block contains a 2-byte count field, which 
contains a number indicating how many bytes 
are used in this block (including this 
count field) . 

The keys of catalog blocks are always 

X' FFFFFFFFFFFFFFFF ' , or 
X'OOOOOOOOOOOOOOOO'. 

A high key indicates that the block 
contains information, and a zero key 
indicates that the block is available for 
new entries. The keys are present because 
the catalog routines use the BLDL routine 
(lECPBLDL) to read the catalog. The BLDL 
routine expects to find 256-byte records 
with 8-byte keys. It ignores blocks with 
keys of zero . 



The catalog is organized into a series 
of indexes or levels. The highest level, 
called the volume index, is initialized by 
the catalog management routines when the 
catalog data set is first opened. 

Entries in each index are in standard 
EBCDIC collating sequence by their name 
fields. 

The volume index is all that is required 
to catalog simple names. It also is the 
only index that may contain control volume 
pointer entries (pointers to another 
catalog) or alias entries. Lower level 
indexes are required to catalog qualified 
names, one index for each level of 
qualification except the last. 

To illustrate the organization of 
indexes, consider the simple data set name, 
•DSET' (Figure 4). If this were cataloged, 
only one entry would be made in the 
catalog : a data set pointer entry in the 
voliame index. However, a two- level name. 
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Figure 3. Typical Block in the Catalog 
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Figure 4. Logical Organization of the Catalog: Normal Index Structure 



such as SYSl. PROCLIB requires another 
index. To catalog this name, two entries 
would have to be made: an index pointer 
entry with name 'SYSl' and a data set 
pointer entry with name "PROCLIB'. 

The periods ( . ) in a data set name act 
as level delimiters. The characters to the 
left of the first period are assumed to 
indicate a name in the volume index, the 
next level is assumed to be the name of an 
entry in the index indicated by the pointer 
in the volume index, and so on, until the 
last level is a name in the lowest level 
index and is associated with a data set 
pointer entry or volume control block 
pointer entry. 

A data set pointer entry and a volume 
control block both contain volume serial 



numbers and device type information for the 
catalog data set. A data set pointer entry 
can contain only five volume serial 
numbers, while a chain of volume control 
blocks can describe any number of volumes. 



A generation data group index contains 
data set pointer entries and volume control 
block pointer entries. Figure 5 shows how 
a catalog containing generation data group 
indexes and volume control blocks might 
look. This sample! catalog lists generation 
data sets named "WEEKLY. INVNTRY.GnnnnVxx" 
to illustrate generation indexes, and a 
data set named "LOTSA. VOLUMES" to 
illustrate volume control blocks. 
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Figure 5. Logical Organization of the 
Blocks 



Catalog: Generation Indexes and Volume Control 



Indexes may span blocks, but one block 
may not contain more than one index, or 
parts of more than one index. The last 
entry in each index block is called an 
Index Link Entry. (See Appendix B for 
specific fields.) If the block is the last 
one in an index, the pointer field of the 
link entry contains zeros. If the index is 



continued in another block, the pointer 
field of the link entry contains the TTR of 
the next block in the index. These link 
entries are present even when the several 
blocks of an index are contiguous (See 
Figure 6) . 
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INDEX ENTRY TYPES 



An index always contains one control 
entry and any number of pointer entries. 
The control entry is always the first entry 
in the index (see Figure 6), and its 
position here is assured by giving it a 
name field of value X'l*. There are two 
types of control entries: volume index 
control entries and normal index control 
entries. The gener^al information about 



these entries is given in Figure 7, while 
specific information about fields and their 
values is given in the section "Data Area 
Layouts , •• 



There are several types of pointer 
entries, A summary of each type and the 
information it contains is given in Figure 
1, while specific information about exact 
placement of fields, etc., is given in the 
section "Data Area Layouts." 



I 



ENTRY TYPE 



I 



CONTENTS 



K- 



Alias Entry 



Contains the name of the alias, a pointer to 
the next lower level index, and the true name. 



CVOL Pointer 
Entry 



Contains the name of a high level index and a 
pointer to the control volume on which this 
index may be found. 



-1 



Data Set 
Pointer Entry 



Contains the lowest level of the data set name 
and up to five entries specifying volume 
serial numbers and device codes for the volximes 
of the data set. 



Index Control 
Entry 



Contains the address of the last block in this 
index, the address of the first block (the 
address of the block which contains this 
entry) , a count of the number of unused bytes 
in the last block of this index, and a count 
of the number of aliases to this index. 



i 



Generation Index 
Pointer Entry 



H- 



Contains the name of the generation index, 
number of entries to be maintained in the 
index, the number of entries currently in 
the index, codes for "delete" and "empty" 
options, and a pointer to the index. 



the 



Index Link 
Entry 



Contains a name field of X'FFFFFFFFFFFFFFFF' , 
and a zero to indicate the end of this index, 
or a pointer to the next block in this index. 



Index Pointer 
Entry 



Contains an index name and a pointer to the 
named index. 



Volume Control 
Block 



Contains an indication of the number of 
volumes named in the block and a list of the 
volume serials, device type codes, and data 
set sequence numbers of these volumes, plus a 
pointer to the next volume control block, or 
a zero to indicate end of chain. 



Volume Control 
Block Pointer 
Entry 



Contains the lowest level of the data set 
name and a pointer to the volume control block 
which describes the volumes of this data set. 



Volume Index 
Control Entry 



Contains the address of the last block in the 
volume index, the address of the last block in 
the SYSCTLG data set, and the address of the 
first available block in the SYSCTLG data set. 
It also contains a count of the number of 
unused bytes in the last block of the volume 
index. 



Figure 7. Index Entries 
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METHOD OF OPERATION 



This section describes the operation of 
each logical function of the catalog 
management routines. Since many of the 
functions are quite similar to each other, 
several of these functions have sometimes 
been combined into one section. The 
sequence of events described in this 
section is the actual sequence of events 
performed by the routines. However the 
division of thfe routines into modiiles does 
not necessarily correspond to the division 
of functions used in this section. 



Since these routines are reenterable, 
they cannot store within themselves. They 
issue a GETMAIN macro instruction for some 
storage area within the user's region. 
This area is freed when the catalog 
routines terminate either normally or 
abnormally. If storage is not available, 
the calling task is abnormally terminated. 



OPENING THE CATALOG DATA SET 



HOUSEKEEPING FUNCTIONS 



Before actually beginning to search or 
update the catalog, the catalog management 
routines must perform some initialization. 
This initialization does two things: 

• It protects the integrity of the 
catalog. 

• It opens the catalog data set. 



MAINTAINING CATALOG INTEGRITY 



Since the catalog management routines 
were designed to operate in 
multiprogramming or multiprocessing 
environments, they must perform certain 
functions to ensure the integrity of the 
catalog with many jobs and CPUs vying for 
the use of the SYSCTLG data set. The first 
thing the program must do, therefore, is to 
protect the catalog from being modified by 
another user before this particular 
modification or search is completed. 

To do this, the catalog management 
routines issue the RESERVE and ENQ macro 
instructions immediately after receiving 
control. The RESERVE macro reserves the 
device containing the control volume that 
the present use of the catalog management 
routines is searching or modifying. This 
is necessary in a multiprocessing 
environment where another CPU might try to 
access or modify the catalog before the 
search or update was complete. The ENQ 
macro instruction informs the Operating 
System that this use of the routines must 
complete before another can begin. This 
prevents other programs under control of 
the same CPU from accessing the catalog 
while it is being modified and from 
attempting to modify while it is being 
modified. 



To ready the catalog data set for 
reading and writing, the catalog management 
routines do not use the data management 
open routine (SVC 19) . Instead they have a 
special open function called through an SVC 
28. This routine bxiilds a data extent 
block and a data control block so that the 
catalog routines can use the BLDL and EXCP 
routines. For a more detailed discussion 
of the open routine, see the section "The 
CVOL Routines." 



The catalog open routine is called 
before each search of a catalog. If a 
search encounters a control voliime (CVOL) 
pointer entry, the old CVOL is closed and 
the new one is opened. 



LOCATE FUNCTION 



Regardless of the particular object of 
one use of the catalog routines - whether 
the user wishes to modify the catalog or 
just locate a data set - the program always 
first tries to locate as much of the 
user-supplied name as possible. 



The locate routine uses the resident 
BLDL routine (lECPBLDL) to search the 
catalog for the user-supplied name. This 
search always begins with the volume index. 
BLDL returns the entry with the desired 
name field, locate examines it, and calls 
BLDL again to find a lower level index or 
returns to the caller (function requested 
is locate) or passes control to another 
phase (function is anything but locate). 

The locate portion of the program then 
passes an error code to other portions to 
indicate how much of the name was found. 
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BLDX, LINKX, AND BLDG FUNCTIONS 



CATALOG AND RECAT FUNCTIONS 



These functions are quite similar to 
each other. First, locate finds as much of 
the user-supplied name as possible and 
notes how much of the name it found and 
what kind of entry it found at the lowest 
level. If anything in the locate process 
is inconsistent with the function 
requested, the index/catalog portion of the 
program frees all its core, dequeues, and 
passes a nonzero return code to the caller. 



For example, assume that a user wished 
to catalog data set 'A. B.C. Locate would 
first search the catalog to find the data 
set pointer entry, and would pass a zero 
error code to index/catalog if it found the 
entry. Index/catalog would immediately 
return with an error code to the caller 
because it cannot catalog a name that has 
already been cataloged. If locate 
indicated that it had found A.B, but not C, 
and that it had found an index pointer 
entry at B, then index/catalog would update 
the index by inserting the new pointer 
entry. 



If the request is to build an index 
(BLDX), index/catalog first finds an 
available block in the catalog and 
initializes it as an empty index. To do 
this, it creates an index control entry and 
an index link entry with a pointer field of 
zero, and writes a high key 
(X'FFFFFFFFFFFFFFFF' ) for the new index 
block. 



A new index pointer entry must then be 
inserted in the next higher level index. 
To do this , index/catalog searches the 
index until it finds an entry which has a 
name field with value higher than that of 
the new index pointer entry and which is 
not an index link entry with a nonzero 
pointer field. When it finds such an 
entry, it inserts the pointer to the new 
index and rewrites the rest of the index. 



The index always must be completely 
rewritten because the insertion of the new 
entry may cause the chain of index blocks 
to break differently. 



To catalog a data set, the program does 
very much the same thing as when the 
function is BLDX or BLDG except that: 

• No new index is created. The new data 
set pointer entry is simply inserted at 
the appropriate place in the existing 
index. 

• If the data set to be cataloged resides 
on more than five volumes, one or more 
volume control blocks (VCBs) must be 
created. The creation of this block 
resembles the creation of a new index 
very closely, except that instead of a 
new index, a new VCB is created. 

To catalog a data set that is part of a 
generation data group (GDG) , the routines 
must first find the absolute generation 
number if only the relative generation 
number was given. First, the latest entry 
in the index is found. This entry will be 
the first one in the index even though it 
has the highest generation number, because 
the catalog stores generation numbers in 
complement form. Then the given relative 
generation number is added to or subtracted 
from the found generation number to give 
the desired true generation number. 

The given name is now compared with the 
present entries in the catalog to check for 
duplications, and the new name is inserted 
as any other Data Set Pointer Entry or VCB 
Pointer Entry. The generation count is 
updated, and, if necessary, the oldest 
entry in the index is removed. The flags 
of the generation index pointer entry are 
checked to see if the index must be emptied 
or if any data sets must be deleted. If 
any data sets have to be deleted, the 
routines transfer control to the Delete 
routine of DADSM by issuing an SVC 29. 
(For a discussion of the Delete routine see 
IBM System/ 360 Operating System Direct 
Access Device Space Management, Y28-6607.) 

For RECAT, the routines uncatalog the 
old data set, then catalog the new, as 
above. 



BLDA FUNCTION 



LINKX is just like BLDX, except that a 
CVOL pointer is created instead of an index 
pointer. 



BLDG is similar, except that the index 
pointer entry contains the appropriate 
generation counts and flags. 



The BLDA function is basically similar 
to the BLDX function, except that BLDA only 
creates a pointer entry; it Duilds no new 
index. 

Locate finds the name for which an alias 
is being built, and checks to be sure it is 
a high-level name. If it is, the routines 
read tne block containing the high-level 
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namer add one to the entry alias count, and 
rewrite the block. 

The routines then create an alias entry 
and insert it in alphameric order into the 
volume index. The volume index is 
reorganized as for BLDG and BLDX. 



DLTX. DLTA. DRPX. UNCAT FUNCTIONS 



The sequence of operations to delete an 
index or an alias or to uncatalog a data 
set or disconnect control volumes is 
basically similar to the other functions 
involving reorganization of the catalog: 

1. The catalog is searched for the 
user-supplied name. In this case the 
entire name must be found. 

2. If a pointer entry is deleted, the block 
it points to must also be deleted. In 
the case of UNCAT, a VCB may have to be 
freed. With DLTX, an index block always 
has to be freed. With DLTA and DRPX, no 
blocks should have to be freed unless 
deleting the pointer makes the volume 
index enough shorter that it takes up 
fewer blocks than before. 

3. To delete a block, the program writes a 
zero key for that block. The data 
inside the block remains unchanged. The 
program recognizes any block with a zero 
key as a free block. 

t^. The index from which the entry was 
deleted is reorganized just as when a 
new entry is added. 



and a data control block (DCB) for the 
SYSCTLG data set using information from the 
unit control block (UCB) and volume table 
of contents (VTOC) of the voluine being 
opened. If no space has been allocated for 
the SYSCTLG data set, an error code is 
returned to the user. 

The Format 1 data set control block 
(DSCB) for the catalog data set has a 
format switch which indicates whether this 
SYSCTLG data set has been previously 
formatted. If the switch shows that the 
data set has not been formatted, the open 
routine passes control to the formatting 
routine. Otherwise, it returns to the 
caller. 



EXTEND ROUTINE 



To extend the data set, the CVOL routine 
transfers control to the Extend routine of 
Direct Access Device Space Management. 
This routine extends the data set by 
updating the VTOC (provided a secondary 
allocation quantity was specified when 
space for SYSCTLG was initially allocated) , 
and transfers control to the formatting 
routine. The formatting routine formats 
the extension, but does not initialize a 
vol\ime index, since there is already one 
present. It does, however, update the 
Volume Index Control Entry to show the 
extra space. 



I 



FORMATTING ROUTINE 



THE CVOL ROUTINES 



The CVOL routines open or extend the 
SYSCTLG data set, format new catalogs or 
extensions of old catalogs, and format 
partitioned data set (PDS) directories. 

The routines receive from their callers 
the address of the Unit Control Block (UCB) 
of the device containing the data set to be 
opened or extended, and a parameter 
indicating whether the request is to open a 
catalog, to extend a catalog, or to format 
a PDS directory. 



OPEN ROUTINE 



If the request is to open a catalog, the 
routines build a data extent block (DEB) 



The formatting routine formats the 
allocated space into 256~byte records with 
8~byte keys, and initializes the volume 
index with a volume index control entry and 
an index link entry with a zero pointer 
field. The key of this block is set to 
X'FFFFFFFFFFFFFFFF' while the keys of all 
the other blocks are set to zero. It sets 
the format switch in the DSCB to indicate 
that the data set has been formatted and 
returns to the caller. 

To format a partitioned data set (PDS) 
directory, only the formatting routine is 
used. The open routine immediately passes 
control to the formatting routine. 

Formatting takes place in the same 
general way as for SYSCTLG data sets, with 
2 56-byte records and 8-byte keys. Instead 
of initializing a volume index, however, 
the routine initializes the first block as 
an empty PDS directory. 
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PROGRAM ORGANIZATION 



The catalog management modules are 
designed to fit in the 1024~byte transient 
areas of the nucleus. They are 
reenterable. In general, the modules pass 
control from one to the other through the 
XCTL macro instruction, although they 
sometimes use SVCs. The following 
discussion will enlarge upon the Method of 
Operation section by discussing the 
routines module by module. Figure 8 shows 
the relationships among the catalog 
management routines and between the catalog 
management routines and other parts of the 
Operating System. 

NOTE: In this discussion, the term 'write' 
always refers to the use of an EXCP macro 
instruction. 'Read' generally refers to 
the use of the resident routine IECPBlDL, 
but the modules occasionally use channel 
programs here, also. 

IECPBLDL, the resident BLDL routine, is 
accessed by the catalog management routines 
through the conununi cation Vector Table 
(CVT) . The routines find the address of 
IECPBLDL in the CVT, put the address of the 
catalog DCB in register 1 and the address 
of the BLDL list in register 0, and execute 
a BALR to the BLDL routine. For the 
functions of the BLDL routine, see IBM 
System/3 60 Operating System Sequential 
Access Methods ^ Y28-6604. 



INITIALIZATION AND HOUSEKEEPING; MODULE 
IGC00Q2F 



Entry to the catalog management 
routines, except the open routine, is 
through an SVC 26, which gives control to 
this module. The module issues an ENQ 
macro instruction on the name 'SYSCTLG' to 
protect against simultaneous modifications 
of the catalog in a multiprogramming 
environment and gets main storage for the 
open routine. It searches the unit control 
block (UCB) table to find the UCB of the 
specified control volume (CVOL) or the 
system residence device (if no CVOL was 
specified) to pass on to the open routine, 
and then reserves the CVOL (if it is not 
the system residence device) to prevent 
accesses by another CPU. It then calls the 
catalog open routine with an SVC 28. It 
checKs the return code from open, and, if 
no error has occurred, it requests the 
appropriate amount of storage for locate or 
index/catalog, via GETMAIN, and transfers 
control to IGGOCLCl. 



IGC0 002F may be reentered from IGGOCLCl 
if that module finds a control volume 
pointer entry which it must follow. The 
only difference this makes in the control 
path through IGC0002F is that IGC0002F does 
not issue the ENQ macro instruction if 
entry was from IGGOCLCl. This is because 
the ENQ was already issued in the first 
pass through IGC0002F. IGGOCLCl passes the 
address of the serial number of the CVOL to 
be opened as a parameter to IGC0002F. 



LOCATE: MODULE IGGOCLCl 



This module always gets control from 
IGC0002F. It searches the specified 
catalog for the supplied name and passes 
control to one of two other modules, 
depending on the function requested and the 
"^^yp^ of entry found at the lowest level. 
An input parameter indicates whether the 
user wishes to locate a data set by name or 
to locate an entry in the catalog by giving 
the TTR of the block. 

If the request is to search for a 
specified block, the module passes the 
block's address to the resident routine 
IECPBLDL. IECPBLDL searches the catalog 
and retiirns the correct entry to the 
caller. The only error possible is that 
the block might be outside of the SYSCTLG 
data set, in which case an error code is 
set and the module returns control to the 
caller. 

If the request is to search for a name 
or to index or catalog a name, IGGOCLCl 
isolates the first level of the name. It 
uses BLDL to search the volume index for 
this simple name and analyzes what type of 
pointer is associated with it. Several 
different things can happen, depending on 
what pointer type was found and what 
function was requested. 

In the most typical case, the routines 
will find an index pointer entry and note 
that there are more qualifiers left in the 
name. In this case, the module isolates 
the next qualifier and searches for that 
name, specifying to BLDL that the search is 
to begin at the TTR specified in the found 
index pointer entry. This process is 
repeated until either all levels of the 
name are exhausted or an entry which is not 
an index pointer entry is found. 
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Figure 8. Catalog Module Flow 



When Locate has found all of the 
pointers it can find, it determines what 
action to take on the basis of what kind of 
pointer was the last found, how much of the 
name could not be found, and what function 
was requested. It may transfer control to 
IGG0CLC2 to build new entries in the 
catalog, it may transfer control to 
IGG0CLC4 to search generation indexes, or 
it may return to the caller via an SVC 3 
with the appropriate error code. 



If control is going anywhere but jDack to 
the caller, Locate reads several relevant 
blocks into main storage: 

• Block Containing Volume Index Control 
Entry - This is necessary to indicate 
where the first available block in the 
catalog is. It has to be updated if any 
new blocks are used or any old ones are 
freed, 

• Block Containing Index Control Entry *- 
This entry is the control entry for the 
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PROGRAM ORGANIZATION 



The catalog manaaement modules are 
designed to fit in the 102t+-byte transient 
areas of the nucleus. Tney are 
reenterable. In general, the modules pass 
control from one to the other throuah the 
XCTL macro instruction, although they 
sometimes use SVCs. Tne followino 
discussion will enlarge upon the Method of 
Operation section by discussing the 
routines module by module. Figure 8 shows 
the relationships among the cataloq 
management routines, as well as between the 
catalog management routines and otner parts 
of the Operating System. 

NOTE : In this discussion, the term 'write' 
always refers to the use of an EXCP macro 
instruction. 'Read' generally refers to 
the use of the resident routine ILCPBLDL, 
but the modules occasionally use channel 
programs here, also. 

lECPBLDL, the resident BLDL routine, is 
accessed by the catalog management routines 
through the communication vector table 
(CVT) . The routines find the address of 
lECPBLDL in the CVT, put the address of the 
catalog DCB in register 1 and the address 
of the BLDL list in register 0, and execute 
a BALR to the BLDL routine. For the 
functions of the BLDL routine, see IBM 
System/360 Operating System Sequential 
Access Methods , Y28-6604. 



INITIALIZATION AND HOUSEKEEPING; MODULE 
IGC0002F 



Entry to the catalog management 
routines, except the open routine, is 
through an SVC26, which gives control to 
this module. 

It searches the unit control block (UCB) 
table to find the UCB of the specified 
control volume (CVOL) or the system 
residence device (if no CVOL was specified) 
to pass on to the Open routine. It then 
calls the catalog open routine with an SVC 
28. It checks the return code from open, 
and, if no error has occurred, it requests 
the appropriate amount of storage for the 
locate or index/catalog routines, via 
GETMAIN, and transfers control to IGGOCLCl. 

IGC0002F enqueues on the catalog 
resources and reserves the specified CVOL. 
The ENQ macro instruction requires two 
names to be specified: a "qname" and an 
"rname." The catalog management routines 
use the followina names: 



qname 
SYSCTLG 



rname 
SYSCTLGbOOua 



Where "ua" is the two-t)yte address of the 
UCB of the CVOL if a CVOL was specified, or 
two bytes of zeros if no CVOL was 
specified. 

IGC0002F may be reentered from IGGOCLCl 
if that module finds a control volume 
pointer entry which it must follow. The 
only difference this makes in the control 
path through IGC0002F is that IGC0002F does 
not issue tne ENQ macro instruction if 
entry was from IGGOCLCl. This is because 
the ENQ was already issued in the first 
pass through IGC0002F. IGGOCLCl passes the 
address of the serial number of the CVOL to 
be opened as a parameter to IGC0002F. 



LOCATE: MODULE IGGOCLCl 



This module always gets control from 
IGC0002F. It searches the specified 
catalog for the supplied name and passes 
control to one of two other modules, 
depending on the function requested and the 
type of entry ^ound at the lowest level. 
An input parameter indicates whether the 
user wishes to locate a data set by name or 
to locate an entry in the catalog by giving 
the TTR of the block. 

If the request is to search for a 
specified block, the module passes the 
block's address to the resident routine 
lECPBLDL. lECPBLDL searches the catalog 
and returns the correct entry to the 
caller- The only error possible is that 
the block might be outside of the SYSCTLG 
data set, in which case an error code is 
set and the module returns control to the 
caller. 

If the request is to search for a name 
or to index or catalog a name, IGGOCLCl 
isolates the first level of the name. It 
uses BLDL to search the volume index for 
this simple name and analyzes what type of 
pointer is associated with it. Several 
different things can happen, depending on 
what pointer type was found and what 
function was requested. 

In the most typical case, the routines 
will find an index pointer entry and note 
that there are more qualifiers left in the 
name. In this case, the module isolates 
the next qualifier and searches for that 
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( Return j 



name, specifying to BLDL that the search is 
to begin at the TTR specified in the found 
index pointer entry. This process is 
repeated until either all levels of the 
name are exhausted or an entry which is not 
an index pointer entry is found. 

When Locate has found all of the 
pointers it can find^ it deterinines what 
action to take on the basis of what kind of 
pointer was the last found, how much of the 
name could not be found, and what function 
was requested. It may transfer control to 



IGG0CLC2 to build new entries in the 
catalog, it may transfer control to 
IGG0CLC4 to search generation indexes, or 
it may return to the caller via an SVC 3 
with the appropriate error code. 

If control is going anywhere but back to 
the caller. Locate reads several relevant 
blocks into main storage : 

• Block Containing Volume Index Control 
Entry - This is necessary to indicate 
where the first available block in the 
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If an entry must be removed from the 
index r IGG0CLC5 removes it and rewrites the 
index block which contained this entry. If 
the empty option is indicated by the flags 
in tne generation index pointer entry, the 
module transfers control back to IGG0CLC4 
to empty the index. If the delete option 
is indicated, the module calls the SCRATCH 
function of Direct Access Device Space 
Management (DADSM)* with an SVC 29 to 
scratch the data set. After the module 
deletes whatever entries it must delete, it 
builds any new entries necessary. 



When all the counts have been updated, 
the necessary entries removed from the 
index, and the specified data sets 
scratched, IGG0CLC5 reads the index to be 
updated and transfers control to IGG0CLC3. 
IGG0CLC3 reorganizes the index just as if 
it were a normal index. 



(information common to all SYSCTLG data 
sets such as blocksize and record format) . 

There is a switch in the DSCB of a 
SYSCTLG data set that indicates whether the 
data set has been formatted or not. If 
this switch is off, IGC000 2H transfers 
control to IGG0CLF2, the formatting 
routine, to format the data set. If the 
switch is on, the module releases any 
unused DEB or DCB space and exits. 

To extend the catalog, the module gets 
main storage for the Extend routine of 
DADSM, reads the format 1 DSCB for SYSCTLG, 
and checks the secondary allocation 
quantity in the DSCB. If this quantity is 
zero, the catalog cannot be extended and 
IGC0002H returns to the caller with an 
error code of 4 . If there is a secondary 
allocation quantity specified in the DSCB, 
the module builds a parameter list for the 
Extend routine and transfers control to 
module IGG0 533A. 



THE CVQL ROUTINES; 
IGG0CLF2 



MODULES IGC0002H AND 



These modules together take care of the 
Open and initialization functions for the 
catalog managemeht routines. IGC0002K 
opens or extendi the catalog by building or 
modifying a data control block (DCB) and a 
data extent block (DEB) for the SYSCTLG 
data set and IGG0CLF2 formats new catalogs, 
extensions of the catalog, and new 
partitioned data set directories. 



The Extend routine of DADSM returns 
control to the beginning of IGC0002H, which 
indicates that the data set must be 
formatted and where the formatting is to 
begin, and then passes control to the 
formatting routine (IGG0CLF2) . It also 
builds a new DEB which includes the newly 
allocated space. 



IGG0CLF2 



IGC0002H 



Tnis module is entered by an SVC 28, or 
by XCTL if returning from the Extend 
routine of DADSM*. If entry is by SVC 28, 
the module opens or extends the catalog, 
depending on input parameters. If entry is 
by XCTL from the DADSM Extend routine, the 
module finishes extending the catalog. 

To open the catalog, the module searches 
the volume table of contents (VTOC) of the 
volume whose unit control block (UCB) 
address was specified by the caller 
(IGGOCLCl or 3) . If it does not find a 
format 1 data set control block (DSCB) with 
name SYSCTLG in the VTOC, it sets a return 
code of 4 and exits. If it does find the 
format 1 DSCB, it constructs a DCB and DEB 
from information in the DSCB and from 
information contained in the module itself 



♦See IBM Systeni/360 Operating System Direct 
Access Device Space Management Program 
Logic Manual , Y28-6607. 



This module formats new catalogs, 
extensions of existing catalogs, and new 
partitioned data set (PDS) directories. It 
does this by filling the available space 
with 25 6-byte records with 8-byte keys. if 
it is formatting a new SYSCTLG data set or 
a PDS directory it also initializes the 
first block. 

If the request is to format a PDS 
directory, the module constructs a channel 
program to write one 256-byte block at a 
time. The first write operation writes an 
empty directory, and each subsequent write 
writes an 8-byte zero key and 256-byte zero 
record. When it has formatted all the 
requested blocks, it writes an end of data 
mark, and returns to the caller via an SVC 
3. 

If the request is to format a catalog, 
the module constructs a channel program to 
write keys and data, a full track at a 
time. The module uses information from the 
DSCB to determine how many blocks will fit 
on a track. It keeps a record of the last 
relative track formatted to insert it into 
the volume index control entry. 
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When the module has reached the end of volume index control entry and an index 

the extent assigned to SYSCTLG, it checks link entry with zero TTR field, and sets 

to see if it has been formatting a new the format switch in the DSCB to indicate 

catalog or an extension. If it has been that the data set has been formatted, 

formatting an extension, it returns Before returning to the caller, the module 

directly to the caller. If it has been always frees the working storage obtained 

formatting a new SYSCTLG data set, it for it by IGC0002H. 
builds an empty volume index, containing a 
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DIRECTORY 



This chart contains information to assist the reader in making the 
transition from this manual to the assembler langioage listings of the 
catalog management modules. It correlates information from three 
sources : 

• The source code 

• The executable load modules 

• This manual 
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DATA AREA LAYOUTS 



This section contains illustrations and 
explanations of the layouts of the various 
types of catalog entries and of the 
parameter list which the user supplies to 
the catalog management routines. 



CATALOG ENTRIES 



This section describes in detail the 
format of each of the possible entries in 
the catalog. Figures 10 and 11 represent 
each entry pictorial ly and the following 
text describes the contents of each field. 

The Volume Index Control Entry contains 
information about the entire catalog and 
the volume index. It is always the first 
entry in the catalog. It is 22 bytes long 
and contains 8 entries. 

Field 1: This is the name field. It 
always contains the value 
X' 0000000000000001' to ensure that this 
entry is always first in the volume index. 

Field 2: This field contains the TTR of 
the last block in the volume index. 

Field 3: This field contains the number 
5 to indicare that five half words of user 
data follow. It also serves to identify 
this entry as a volume index control entry, 
since this is the only entry that is 
twenty- two bytes long (total) . 

Field 4: This field contains the TTR of 
the last block in the SYSCTLG data set. 

Field 5: This is the alias count field 
in a normal index, but since this is the 
volume index it will always contain zero. 

Field 6 : This field contains the TTR of 
the first unused block in the catalog. 

Field 7: This field contains zero. 

Field 8: This field contains a count of 
the number of unused bytes in the last 
block of the volume index. 

An Index Control Entry is quite similar 
to a volume index control entry, but it 
only contains information about the index 
which it begins. It is 18 bytes long and 
contains six fields. 

Field 1: This name field contains 
X' 0000000000000001' to ensure that this 
entry is first in its index. 



Field 2: As in the volume index control 
entry, this field contains the TTR of the 
last block in this index. 



Field 3: This field contains the number 
3 to indicate that three half words follow. 
It identifies this entry as an index 
control entry. 



Field U: This field contains the TTR of 
the first block in this index. This 
address is always the address of the block 
which contains this entry. 



Field 5: This field contains a count of 
the number of aliases in the catalog that 
reference this index. This count will be 
nonzero only for indexes one level removed 
from the volume index, 

Field 6: This field contains a count of 
the number of unused bytes in the last 
block of the index. 

Index Link Entries and Index Pointer 
Entries are quite similar. An index link 
entry is used to chain several blocks of an 
index together and an index pointer entry 
is used to chain an index to the next lower 
level index. An index link entry is always 
the last entry in any index block. These 
blocks contain three fields and are 12 
bytes long. 

Field 1: This is the name field and 
contains the name of the index to which 
this entry points. If the entry is an 
index link entry, the name field contains 
X' FFFFFFFFFFFFFFFF' . 

Field 2: This is the pointer field and 
contains either the TTR of the first block 
of the index, in the case of an index 
pointer entry, or the TTR of the next block 
of the index, in the case of an index link 
entry . 

Field 3: This is the count field, and 
it contains zero to indicate that the entry 
ends here. 

The Data Set Pointer Entry contains the 
actual information for which the catalog 
exists: the volume serial number, data set 
sequence number, and device type code of 
the data set which the fully qualified name 
represents. The entry can be from 26 to 74 
bytes long, depending on how many volumes 
the data set occupies. 
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Volume Index Control Entry 



Field 1: Name 


Field 2: 


05 


Field 4: 




Field 6s 




Field 7: 




TTR of lost 




TTR of last 




TTR of first 




Count of 


X'OOOOOOOOOOOOOOOl' 


block in 


C 


block in 




unused block 




unused 




volume 
index 


O 
U 
N 

T 


SYSCTLG 
data set 


00 


in SYSCTLG 
data set 


00 


bytes in 
lost block 
of volume 
index 


7 


8 10 


n 12 14 


)5 16 18 19 20 21 




■ Total Length: 


22 
















"l 



Index Control Entry 



Field 1: Name 




Field 2: 


03 


Field 4t 




Count of 






TTR of last 




TTR of first 


*n*7 


unused 


X'OOOOOOOOOOOOOOOl' 




block in this 


C 


block in 


58 


bytes in 






index 


O 


this index 


last block 








u 




of this 








N 
T 






index 





7 8 10 


11 12 








Kb 




■^1 



Index Link Entry 



Field 1: Name 
X'FFFFFFFFFFFFFFFF' 


Field 2: 
TTR of next 
block in 
index 

(or zero if no 
next block) 


00 

c 
o 
u 

N 

T 


7 8 10 


n 




c oyres 





Index Pointer Entry 



Field 1: Name 

Index Name (padded to right 
with blanks if necessary) 




7 8 10 11 
- Total Length 1 2 bytes • 



Data Set Pointer Entry 



Field 1: Name 

Lowest level name of data 

set or complemented generation 

number (If part of GDG) 



Field 2: 
Dummy 
pointer field: 
zeros 



Field 4: 
Volume 
Count 



Field 5: 
Devi(±e Code 



Field 6: 

Serial Number of volume 

on whioh data set resides 



Field 7: 
DiSita set 
sequence 
number 
(zero for 
direct 



10 



11 12 13 04 



17 18, ... ^ ^ ^ 23 

Repeated for each volume 



Count: equal to 6 times the number 
of volumes^ plus 1 . 



Total Length 26 to 74 bytes 



HV- 



Figure 10. Catalog Entry Formats 
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Volume Control Block Pointer Entry 





Field 1: Nome 


Field 2: 




01 


Field 4: 




Lowest level of data set name 


TTRof 




C 


Dummy 






Volume 




o 


data 






Control 




u 


entry: 






Block 




N 
T 


zeros 





7 


8 

1 A k^^<>c - 


10 11 


12 13 



Volume Control Block 



C 
O 
U 
N 
T 



Field 2: 
Device 
Code 



Field 3: 
Serial number 
of volume n 



Field 4: 

Data set sequence 
number for the 
volume described 
in field 5. Zero 
for direct access 



Field 5: 

Ten bytes of zeros 



Field 6: 
TTR of next 
volume control 
block, or zero 
if none 



00 



1 



m+3 m+4 



m+9 m+10 



m+12 241 



250 251 



254 255 



Repeated once for each volume; total 6 to 20 



^v 



Total Length: 256 bytes - 



Control Volume Pointer Entry 



Field 1: Name 
Name of index on 
other control volume 



Field 2: 
Dummy pointer 
field: zeros 



Field 4: 

Device Code of 
control volume 



Field 5: 

Serial number of 

control volume 



7 8 



10 11 
-Total Length: 



12 

22 bytes - 



15 16 



NOTE: 



Prior to release 17, the Control Volume Pointer Entry contained a count 
of 03 and did not have a Device Code field (Field 4) 
Alias Entry 





Field 1: Name 




Field 2: 


04 


Field 3: 






Name of alias 




TTR of index 
named in field 
3 


C 
O 
U 
N 
T 


Name of high level index 
to which this is an alias 









7 8 10 11 12 


19 






Tn 


^al Length: 20 byt< 
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Generation Index Pointer Entry 











*i 


*2 






Field 1: Name 


Field 2: 


02 






Field 6. 




Name of generation index 


TTRof 

generation 

index 


C 
O 
U 
N 

T 






Count of 
genera- 
tions 
currently 
in index 





7 8 10 


n 12 


13 14 15 


^ 










lorai Length 


1 o oyres 











Field 4: 
Flags: 



Field 5: 



bits 

0-5 
6 
7 



meaning 

Reserved 

Delete 

Empty 



Count of maximum gererations to be maintained in index 



Figure 11, More Catalog Entry Formats 
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Fields one through four occur only once 
while fields five through seven occur once 
for each volume of the data set. 

Field 1; This field contains the lowest 
level of the data set name. 



number of volumes described by this volume 
control block and any following it. For 
example the count fields of a series of 
VCBs for a data set that occupied sixty 
volumes would show sixty, forty, and twenty 
as the volume count. 



Field 2: This would normally be the 
address field, but since a data set pointer 
entry references no other entries in the 
catalog, it contains zeros. 

Field 3: Count of user data. This 
field indicates how many halfwords of data 
follow. The number in here will be six 
times the number of volumes (there are six 
halfwords for each volume) plus one (for 
the volume count) . 

Field 4: This field contains a count of 
the volumes following (one to five) . 

Field 5: This field contains the device 
type code of the device on which the volume 
with the following serial can be mounted. 
(See Appendix C.) 

Field 6: This field contains the volume 
serial number of one of the volumes of the 
data set. 

Field 7 : This field contains the 
sequence number of the data set on a 
magnetic tape volume. It is zero for any 
other device. 

A Volume Control Block Pointer Entry is 
used instead of a data set pointer entry 
when the data set occupies more than five 
volumes. This entry points to a volume 
control block, which, in turn, describes 
the data set. The entry is 14 bytes long. 

Field 1: This name field contains the 
lowest level of the data set name. 

Field 2: This field contains the TTR of 
the first (or only) volume control block 
for the data set. 

Field 3: The count field contains zero 
to indicate that this is the end of the 
entry. 

A Vol time Control Block contains the 
description of all the volumes of a data 
set which resides on more than five 
volumes. One volume control block can 
describe up to twenty vol\iir:es and volume 
control blocks may be chained together, so 
that a data set can be cataloged no matter 
how many volumes it requires. The volume 
control block is always 256 bytes long, 
regardless of how many volumes it 
describes. 

Field 1: The first two bytes of a 
volume control block contain a count of the 



This is the only kind of block in the 
catalog in which the first two bytes are 
not used as a count of the number of used 
bytes in the block. 

Field 2: This field can contain up to 
twenty 12-byte volume descriptions, 
consisting of device type codes (see 
Appendix C) and volume serial numbers. 

Field 3: This field contains ten bytes 
of zeros, followed by the TTR of the next 
volume control block for this data set, 
followed by one byte of zeros. If there 
are no more yolume control blocks for this 
data set, the TTR is zero. 

A Control Volume Pointer Entry is used 
to indicate that a particular index resides 
on a volume other than the system residence 
volume. Control volume pointer entries can 
exist only in the voliame index. They are 
22 bytes long. 

Field 1: The name field contains the 
name of the high level index which resides 
in the volume described by this entry. 

Field 2: The address field contains 
zeros, because this entry references no 
others in the catalog. 

Field 3: The count field contains the 
number three to indicate that three 
halfwords follow. 

Field 4: This field contains the device 
type code of the specified control volume. 
(See Appendix C.) 

Field 5: This field contains the volume 
serial number of the control volume which 
has an entry in its volume index of the 
same name as this entry. 

An Alias Entry is used to specify a 
substitute name for a high level index. 
Alias entries only appear in the volume 
index. They are 20 bytes long. 



Field 1: 
alias. 



The name field contains the 



Field 2: The address field contains the 
TTR of the first block of the index for 
which this entry specifies an alias. 

Field 3: The count field contains the 
number 3 to indicate that three halfwords 
of data follow. 
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Field 4: This field contains the true 
name of the index for which this entry is 
an alias. 

A Generation Index Pointer Entry points 
to a generation index. It is basically the 
same as an Index Pointer Entry, except that 
it includes the flag and count fields. It 
is 16 bytes long. 

Field 1: The name field contains the 
lowest level name of the generation data 
group. That is, a generation data set 
named WEEKLY. INVNTRY. GOO 01 VOO would have 
the name "INVNTRY" in the generation index 
pointer entry name field. 

Field 2: The address field contains the 
TTR of the first block of the generation 
index . 



Field 3; The count field contains the 
number 2 to indicate that two halfwords 
follow. 



Field 4: This field contains the flags 
which indicate special handling for 
generation data sets. Bit 7 indicates the 
Empty option and bit 6 indicates the Delete 
option. Bits 0-5 are reserved and are 
always zero. 



Field 5: This field indicates the 
maximum number of entries to be maintained 
in the index at one time. 



Field 6: This field indicates the 
number of entries currently in the index. 
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USER'S PARAMETER LIST 

This parameter list must be supplied by the user before he calls the 
catalog management routines- The CAMLST macro instruction, described in 
IBM Svstem/360 Operating System Programmer's Guide , form C28-6550, can 
be used to generate the list. 
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Register 







4 4 



8 8 



12 



Option 

Flags 

(see below) 



Generation 
Count 



Pointer to Fully 
Qualified Name 



Pointer to Serial Number 
of Control Volume 



Pointer to User's Work Area 



^ At entry to IGC0002F, register 1 points to the user's parameter list. 
At all other times, register 8 points there. 



Byte 1. . 
.X. 
.1 



Byte 1 X 



Byte 2 1 



.1 



.XX . 
.. . 1 



.XXX 



Option Flags 

Catalog is on System Residence Device 

Reserved 

Catalog a data set 
Recatalog a data set 
Uncatalog a data set 



CTLG 

RECAT 

UNCAT 

Reserved 

BLOCK 

Reserved 

Reserved 

BLDX 

BLDG 

BLDA 

LINKX 

DLTX 

Reserved 

DLTA 

DRPX 

DELETE 

Reserved 

EMPTY 



Reserved 



I 



Read a block by TTR 



Build normal index structure 

Build generation index 

Build an alias to a high-level 

name 

Connect control volumes 

Delete an index Structure 

Delete an alias entry 
Disconnect control volumes 
Scratch generation data sets 
when they are uncataloged 

Remove all entries from the 
index when the maximum gen- 
eration count has been reached 



Note: 



Function is locate by name if all flags are zero. 



Figure 12. User's Parameter List 
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DIAGNOSTIC AIDS 



This section includes ndscellaneous charts and tables that might be 
iiseful in locating program errors, 



MODULE SELECTION CHART 



This chart can be used to determine what modules of the catalog 
management routine will be used to perform a particular function, given 
the function required and the current status of the catalog. 



,pj.-.^«^_^^^-.^_^-.^-^ 

||1|2|3|4|5|6|7|8| 
|+.+-|«|^+^+.+.^«^ 

FUNCTION: LOCATE llYlYl | | | | | | 

^^+-^.-+«+-+^+^^..^ 

OTHER II I |Y|Y|Y|Y|Y|Y| 
^.+^+^|^|^|^+.+^+^^ 

TYPE INDEX FOUND: NORMAL ||Y|Y|Y| | | | | | 
+|^+^4.^+.+-|^+.+_^ 

GENERATION || JYJ j | | |Y|Y| 
|+.4^+^+^|-+^+^|.^ 

NONE II II I |Y|Y| I I 
++^|^4.^+-^.^+.+^|^ 

UNFORMATTED CATALOG | j j | N | Y j N | Y | N | Y | 

+^.«|.4.^l^l^+.+«l.^ 

IGC0002F ||X|X|X|X|X|X|X|X| 

^.^.>+«4..^.,+>^.>^..4^ 

IGC0002H I |X|X|X|X1X|X|X|X| 

++^+^4^^.-l_^..+.+«^ 

IGG0CLF2 II I I |X| |X| |X| 
++^+^4..4.^+^+.+^4^^ 

IGGOCLCl I |X|X|X|X|X|X|XJX| 
^.+^+^|^+^|^+^+«+.^ 

IGG0CLC2 11 I |X1X|X|X| | | 
++«+^4..4.^+.+.+^+^^ 

IGG0CLC4 II !X| I I I |X|X| 

— ^„+-+.|.4.^^..^.^+.^ 

IGG0CLC5 II I I I I I |X|X| 

++^|.4.«+^4..|^+^+^^ 

IGG0CLC3 II I |X|X|X|X|X|X| 



Figure 13. Module Selection Chart 
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REGISTER USAGE 

Figure 14 is a register usage chart. In the chart, the contents of 
certain registers are given as they appear at entry to each module and 
just before each module loses control. All entries in the table, except 
those marked •**", are addresses. That is, when the table indicates that 
at entry to module IGGOCLCl register 9 is 'DCB' , this means that 
register 9 contains the address of the data control block. When the 
table indicates that at entry to module IGG0CLC2 register 6 is "No. of 
Levels Searched *," this means that register 6 contains that number. 
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Module Name 







1 


2 3 


4 


5 


Registers 
6 8 


9 


10 


11 


12 


13 15 


IGC0002F 


Entry 




User's 
List 






SVRB 
















Exit 










ENQ 
List 




User's 

Parameter 

List 


DCB 






Work Area 


BLDL 
Work Area 


IGGOCLCl 


Entry 










ENQ 

Parameter 

List 




User's 

Parameter 

List 


DCB 






Work Area 


BLDL 
Work Area 


Exit 

(To IGG0CLC2 

or IGG0CLC4) 










ENQ 
List 


No. of 
Levels 
Seorched* 


User's 

Parameter 

List 


DCB 




Generation 

Index 

Block 


Work Area 


BLDL 
Work Area 


Exit 
(To User) 


No. of 
Levels 
Searched* 


Locate 
Error Code* 




















Error Code* 


IGG0CLC2 


Entry 












No. of 
Levels 
Searched* 


User's 

Parameter 

List 


DCB 


Work Area 








Exit 












No. of 
Levels 
Searched* 


User's 

Parameter 

List 


DCB 


Work Area 








IGG0CLC3 


Entry 














User's 

Parameter 

List 


DCB 


Work Area 








Exit 


No. of 
Levels 
Searched* 


Locate 
Error Code* 




















Index 
Catalog 
Error Code* 


IGG0CLC4 


Entry 










Entry 
Indicator* 




User's 

Parameter 

List 


DCB 






Work Area 


BLDL 
Work Area 


Exit 










Entry 
Indicator* 




User's 

Parameter 

List 


DCB 




Gen. Index 

Pointer 

Entry 


Work Area 


BLDL 
Work Area 


IGG0CLC5 


Entry 










Entry 
Indicator* 




User's 

Parameter 

List 


DCB 




Gen. Index 

Pointer 

Entry 


Work Area 


BLDL 
Work Area 


Exit 
(User) 


No. of 
Levels 
Searched* 


Locate 
Error Code * 




















Index 
Catalog 
Error Code* 


Exit 
(IGG0CLC3) 














User's 

Parameter 

List 


DCB 






Work Area 


BLDL 
Work Area 


Exit 
(IGG0CLC4) 










Entry 
Indicator* 




User's 

Parameter 

List 


DCB 






Work Area 


BLDL 
Work Area 


IGG0CLC6 


Entry 






Index 
Cato-log 
Error Code* 


Locate 
Error Code* 




No. of 
Levels 
Searched* 




DCB 








Locate 
Work Area 




Exit 


No. of 
Levels 
Searched* 


Locate 
Error Code* 




















Error Code* 


IGC0002H 


Entry 
(Via SVC 28) 




UCBof 
CVOL or 
DCB 




















Work Area Bin Number 
for DEB/DCB if CVOL is 
on 2321* 


Entry 

(XCTL from 
Extend Routine) 


A Negative 
Value* 






Extend 
Work Area 






Bin Number 
if 2321* 


DCB 


TTR of 
new Extent* 


UCB 






Exit 
(To Caller) 


Error Code* 


Exit 

(To DADSM 
Extend Routine) 




DCB 




Work Area 


DEB 








UCB 






Non-zero* 


Exit 
(To IGG0CLF2) 


Zero* 


DCB No. of Subpool ID 

Blocks/Track and Size of 

Work Area* 


Work Area 




Begin TTR* 














IGG0CLF2 


Entry 




DCB 




Work Area 


DEB 








UCB 






N on -zero* 


Exit 


Error Code* 



Figure 14. Register Usage 
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APPENDIX A; FLOWCHARTS 



These flowcharts illustrate the operation of the catalog management 
routines module by module. Each label in the charts is taken directly 
from the assembler language source code for the module. The charts are 
intended to bridge the gap between the textxaal materi,al of this manual 
and the code itself, so they are best used in conjunction with the code 
land the text (particularly the Program Organization section). 
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iacooo2P 



•ENTER VIA SVC26* 

♦ OR XCTL FROM ♦- 

♦ IGGOCLCl ♦ 

*4> 41*41 4I********* 



. ♦ ENTRY ♦ . 

>*. VIA XCTL FR . 

*. IGGOCLCl .* 



* * * * 

* ♦ENQOEOE ON ♦ ♦ 
->♦ ♦ SYSCTLG ♦ ♦ 

* ♦ RESOURCE ♦ ♦ 

* * * * 
*4i******«4<**4i**4<* 



ERR«» 

*SET ERROR CODE ♦ 


UCBLOOP .♦. 

B2 ♦. 
.♦ * 
YES .* IN A 

< ♦. CVOL LOOP 


* * 


♦ . .♦ 

*. .♦ 



**** 



♦ ♦ RELEASE * * 

♦ * RESERVED ♦ ♦ 

♦ ♦ DEVICE. ♦ * 

♦ ♦DEQUEUE ON * ♦ 

♦ ♦ SYSCTLG * ♦ 
***************** 



♦♦**D1 ***♦♦*♦♦♦ 

* RETURN TO ♦ 

* CALLER ♦ 

* * 

*******tL******* 



r***C2********* 

♦ GET MAIN * 
♦STORAGE FOR^ 

♦ OPEN ♦ 

♦ FUNCTIONS ♦ 

HL*^***0*****t* 



.♦ IS ♦ 

♦. CONTROL VOL 
♦. SPECIFIED. ♦ 



***E2********* 



*****D2********4 
* 

♦SEARCH FOR UCB 
->♦ OF SPECIFIED 
♦ VOLUME 



FOUND . ♦ 1 



♦ 

♦ Bl 



TESTDEQ V 

***i*^;i*i,******** 

♦ ♦RELEASE ANY* ♦ 

♦ ♦PREVIOUSLY * ♦ 
>♦ ♦ RESERVED ♦ ♦ 

♦ ♦ DEVICE ♦ ♦ 

♦ ♦ * ♦ 
***************** 



CATRES 

*****f2********** 

♦ ♦ RESERVE ♦ ♦ 

♦ ♦CVOL IF NOT^ ♦ 

♦ ♦ SYSTEM ♦ ♦ 

♦ ♦ RESIDENCE ♦ ♦ 



♦ ♦ 



♦ ♦ 
*0i^**t******** 



♦ ♦ OPEN * 

♦ ♦ CATALOG ♦ 

♦ ♦WITH SVC 28* 

♦ ♦ ♦ 

*0****0*t**0***0: 



*****111**** ****** 

* * * * 

* ♦GETMAIN U08* ♦ 

* ♦ BYTES IN ♦ ♦< 

* ♦ SUBPOOL ♦ ♦ 

* * * * 

****tH^**0**it**^,** 



♦♦♦♦Jl ♦♦♦♦♦♦*♦♦ 



***^t***0*******. 



****Y,±********* 



.* IS ♦. YES 

->♦. RETURN CODE .♦ , 

♦. LT 8 .♦ I 



♦ Bl ♦ 

♦ ♦ 
♦ ♦♦♦ 



♦ ♦GETMAIN 896^ 

♦ ♦ BYTES IN ♦ 

♦ ♦ SUBPOOL ♦ 

♦ * * 
**0***if******** 



****0Y!.2********** 



*****jS********** 



***********0**0** 



••->♦ CI ♦ 
♦ ♦ 
♦ ♦♦* 



***i^******* 



*t*************** 



♦♦**K4 *♦♦♦♦♦*♦♦* 

* 

SET ERROR CODE ♦ 

TO 2«» ♦ 1 

**********ti**t** i/ 



♦ ci ♦ 

♦ * 
♦ ♦*♦ 
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CATALOG MANAGEMENT 
IGGOCLCX 



*032* 
♦ AU* 



****A1********* 

♦ ENTRY XCTL FR ♦ 

♦ 1GC0002F * 

♦ * 



* 

♦INITIALIZE TTR 
,__>♦ TO SEARCH 
* VOLUME INDEX 



FUNCTION " 
LOCATE BY 
. BLOCK .' 



4>*<»4i*Q3«4i4i**4i4>4i*4< 



GETNAME V 

* SEPARATE A * 

♦ SIMPLE NAME ♦ 
>* PROM THE ♦ 

♦QUALIFIED NAME ♦ 



**4<0*B5^ ♦♦♦♦♦♦♦♦♦ 



•^ ivj itCiK'^im oar '• 
♦ LOCATE SW ON ♦ 



«4[*4i******««**«4>* 



*032+ 

♦ C3 ♦-> 



>■->♦ E3 ♦ 



♦ user's VALUE ♦ 

♦ * 



*4i*4i4i***4>4>4><t>***** 



4.**#*Q5*4>««****4>* 



♦READ SPECIFIED ♦ 

♦ BLOCK USING ♦ 

♦ BLDL ♦ 



**4i**£2^^^ ♦♦♦♦♦♦♦ 



♦ MOVE CATALOG ♦ 


YES .♦ IS ♦ 


♦ DATA TO USER ♦< 


♦. LOCATE SW 


♦ AREA ♦ 


♦. ON .♦ 


* * 


♦ . .♦ 




♦ . .♦ 






" NO 










< ^ 


CATENTRY .♦. 


t^t**F2********** 


F3 ♦. 


♦ ♦ FREE ALL ♦ ♦ 


.♦IS ♦. 


♦ ♦ MAIN ♦ ♦ 


. ♦ LOCATE ♦ 


♦ ♦ STORAGE ♦ ♦ 


♦.ERROR CODE GT 


♦ ♦ USED ♦ ♦ 


♦. 12 .♦ 


* * * * 


♦ . . ♦ 




♦ . .♦ 






♦ YES 


**** 








♦ 032^ 








♦ QZ ♦-> 








« * 








**** 








i V 


■) 


4t4i«**G2^ ♦♦♦♦♦♦♦♦♦ 


i^4'***G3********* 


* ♦'"'^iELEASE^^J * 

♦ ♦ "SYCTLG* ♦ ♦ 




♦ MOVE LOCATE 


♦ ERROR CODE TO 


♦ ♦ AND ( 


:voL ♦ ♦ 


♦ REGISTl 


:r one 



«*«4i4c4i4c***«*4i4t 



♦♦♦♦H2^^+^^^^^^ 

♦ return to 

♦ CALLER 

♦ 



***** 
♦033^ 

♦ Al^ 
* * 



***************** 

**** 

* * 

->♦ E3 ♦ 



**4>4i«4i4t«*4i4t4i** 



#4>***H3^ ♦♦♦♦♦♦♦♦♦ 



***************** 



***FH************ 
READ INDEX S 
♦ VOL INDEX ♦ 
-> CONTROL 

♦ BLOCKS ♦ 



****GH********* 

* XCTL TO ♦ 

* IGG0CLC2 ♦ 

* * 
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CATALOG MANAGEHENT 
IGGOCLCl 



***** 
♦033* 
♦ Al* 



.♦ WAS *. TfEl 

->*. DELIMITER A .* — 
*. BLANK .» 



<!<*•**«*******« 



♦ »*♦* 
♦032* 

* E3* 



IS IT A 
DATA SET 
. POINTER 



.* THERE ♦. YES 

ANOTHER . * 

*. QUALIFIER-* 



* IS IT A ♦. YES 

GEN. INDEX .* 

♦. POINTER .* 



4t**i»4i4>4[*4>4c 



.♦ WAS *. NO 

->*. DELIMITER .* 

*. BLANK .* 



* YES 

1 .•-. 

l_>* AH * 



ENTRY A 

CVOL 
POINTER , 



4i***D 3* ********* 

* 
SAVE ADDR OF * 
GEN INDEX *- 
POINTER * 

* 



FUNCTION 
LNKX OR 
. DRPX 



* SET UP VOL 
* SERIAL AND XCTL' 

♦ INDICATOR 

* 



«**4'G2********* 

* XCTL TO * 

* IGC0002F * 

* * 



**4<4<f34i*«4>*****« 



*4.**4t4>**4<4>4<***4i 



* * 

*SAVE DELIMITER * 
>* AND ADDR OF * 

* DELIMITER * 

* ♦ 

****** ***4.***4.**4. 



****E4********** 



**************** 



***** 
*032* 
* E3* 

* * 



* IS ITS 

DELIMITER , 
* . BLANK 



***G((** ********* 

* READ INDEX * 
AND VOL INDEX 
CONTR ELKS * 
*************** 



****Ht********* 



********** 



***** 
*032* 
* E3* 



*************** 
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CATALOG MANAGEMENT 
IGGOCLCl 



***** 
*034* 
♦ Al* 

* * 



Al ♦. ♦♦♦♦♦A2********** 

.* ♦. * * 

♦ IS *. YES ♦SET ERROR CODE * 

ENTRY A VCB .* >♦ TO ZERO *- 

♦. POINTER .* * * 

♦ . .♦ * * 



■'1; 
***** 
*032* 
* A4* 



THERE *. YES 

ANOTHER .* 

•QUALIFIER-* 



*4.******4i*4>**4>: 



.♦ THERE *. 
->♦. ANOTHER 

♦.QUALIFIER.* 



***4i«B3********** 

* * 
*SET TTR IN USER* 
♦AREA TO TTR OF * 

* VCB * 

* * 
*i^*^i*t *********** 



♦ 032* 

* C3* 



*****l^ti********** 



****ift*********** 



♦032^ 
♦ C3 + 
* * 



^f^,*rt,i;j2********* 

ENTRY VIA BAL ♦ 

CALLBLDL,1'» ♦ 

* 

t************** 



**E2******** 

READ 
SPECIFIED 
BLOCK AND 

NAME 



.♦ THERE ♦. YES 

♦ .UNCORRECTABLE. ♦ 

♦.I/O ERROR. ♦ 



**if** ********** 



tlHf^it:p2********** 

* ♦ FREE ALL ♦ ♦ 

* * MAIN * * 

* * STORAGE * *- 

* * USED ♦ ♦ 

* * ♦ ♦ 
tin^^^t *********** 



****G3********** 



*««*4c4t**4.4.*4,«**4c* 



*4[it>4i4ipl4*4>4i*«4.***« 



NO .♦ IS 

♦. FUNCTION 

♦. LOCATE 
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CATALOG MANAGEMENT 
IoGOCliC2 



•♦•♦Al********* 
*Et>ITHY VIA XCTL * 

♦ Fft IGGOCLCl ♦ 

* « 



Bl ♦. 

.* WAS *. 

.*i>IAMED ITEM ♦. 

. FOUND IN .♦ 

*. CATALOG .♦ 

*. . * 



CATPHASE .♦. 

A2 *. 

.♦DO ALL ♦. 
.♦HIGH LEVEL ♦ 
r~>^. INDEXES 

♦. EXIST .♦ 



*****p^2********** 



>♦ 



***** 
*Q3b* 
♦ A2* 



IS 
FUNCTION 
. CATALOG 



*^*4********* 



.* ARE *. 
.♦THERE MORE ♦. NO 

>*. THAN 5 .♦ 

A ♦. VOLS .♦ 



*****QH********** 

♦ * **** 

♦ CALC ENTRY * * * 
— >*LENGTH, MOVE T0+ >♦ H2 ♦ 

♦ USER AREA ♦ * ♦ 



♦ 035^ 

♦ B3^ 
***** 



I**** 
♦ 037^ 
->♦ A3 ♦ 



C3 ♦. 
.♦IS THE ♦. 
♦ NAME ♦. YES 
UNQUALIFIED . ♦ 



i,************ 



♦♦♦♦♦CU ♦♦♦♦♦♦♦♦♦♦ 

♦ SET UP LNGTH ♦ 

♦ FIELD (X'03') ♦ 
->^FOR CVOL PTR, O^- 

♦ TTR ♦ 
4> * 
t,***^if *********** 

**** 



*««**C5^^ ♦♦♦♦♦♦♦♦ 

* * 

♦ MOVE CVOL ♦ 
->♦ SERIAL NO. TO ♦- 

♦ USER AREA ♦ 

* * 
************t**0^ 



* DU ♦—• , 

*....♦ 

TURN 1 



FUNCTION 
BLDX OR 
. BLDG 



«**«*4i4.«4<«*4i« 



****un********* 

♦ XCTL TO ♦ 

♦ IGG0CLC6 ♦ 

♦ * 



4i:»4>««4>«*4i ««««*4i4. 



♦ WRITE NEW BLK ♦ 
♦SEARCH FOR NEXT+ 

♦ HOLE ♦ 



READ INOEX 
BLK TO BE 
ALTERED 



♦ XCTL TO 

♦ IGG0CLC3 



t****G2********* * 

* * 
♦MOVE GENERATION ♦ 

->♦ COUNT TO USER ♦ 

♦ AREA ♦ 

^*^Lll•*i^t ********** 



H3 ♦. 
.♦ WAS ♦. 
♦ EMPTY ♦. YES 

OPTION . ♦ 

♦. SPECIFIED. ♦ 



DOPTION .♦. 

J3 ♦. 
. ♦ WAS ♦ . 
.♦ DELETE ♦. YES 

♦. OPTION .♦ 

♦. SPECIFIED. ♦ 



♦ NO 
_J< 



0**^^tjmL****** 
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***** 
*036* 
* A2» 



CATALOG MANAGEMENT 
IGG0CLC2 



NO .♦ WAS A *. 
r — *. CVOL PTR .*<- 
*. LOCATED .* 



*035* 

♦ H2* 

* ♦ 



. * LOCATE 
*. ERROR CODE 
♦ . 12 



FUNCTION 
RECAT OR 
. UNCAT 



.♦ >*. 



FUNCTION 
BLDA OR 
. DLTA 



**** 

*035* 

->* D3 * 



ALIAS .*. 

B3 *. 
.♦IS THE ♦. 
.♦ NAME *. YES 
>*. UNQUALIFIED .♦ 



***** 
*035* 
* D3* 



.1.. 



.♦ IS 
->*. FUNCTION 
*. DLTA 



* * A5 ♦ 

* * ♦ 

* **** 

DALIAS 

YES . ♦ * 

* >*. 



***** 
* *035* 
5* * B3* 



4>****E2********'i 



************* 



***** 

♦035* 
♦ D3^ 



.* INDEX A ' 
♦. HIGH LEVEL 
♦ . INDEX . 



*4i4i**Q44r*4i ******* 



4i4>***«*****4>**4i4>* 



ACOUNT 

♦CNVT 037A1+ 
»___ -* 

♦WRITE BACK ORIG^ 
♦ENTRY WITH NEW * 
♦ ALIAS COUNT ♦ 



ALIAS BLK 
. FOUND 



•■-1 



.♦ DOES ♦. NO 

. INDEX HAVE .♦ 

♦.AN ALIAS .* 



n 



*035^ 

♦ DH* 

* « 



FRETBLK 

♦CNVT 037A1^ 



>♦ FREE BLK BY ♦- 

♦ WRITING ZERO ♦ 

♦ KEY ♦ 



YES .♦ IS ♦. 

♦. ANOTHER VCB . ♦<- 

♦.IN CHAIN .♦ 



.♦IS THIS^. 
♦ NOW 1ST ♦ 

HOLE IN 
♦. CATALOG .♦ 



YES .♦ WAS 

*. THIS BLK A 

* . VCB 



♦UPDATE VOL INDX^ 

♦CNTRL BLK WITH ♦ 

>♦ ADDR OF 1ST ♦ 

♦ HOLE ♦ 



****** 



**** 



**** 

* 
A5 * 



***** 
♦035 + 
♦ H2* 
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CATALOG MANAGEMENT 
IGG0CLC2 



***** 
*037* 
♦ A3* 



CNVT 

•♦**A1********* 

* * 

* ENTER VIA BAL * 

* * 

«4.«*********«i*« 



♦♦**B1********* 

* * 
♦CONVERT TTR* 
♦TO ABSOLUTE^ 

♦ DISK ADDR ♦ 



«4<4>4>*«*** 



*4>««*C1********** 

♦ ♦ EXECUTE ♦ ♦ 

♦ » SPECIFIED ♦ ♦ 

♦ ♦ CHANNEL ♦ ♦ 

♦ * PROGRAM ♦ ♦ 

♦ * * * 

*4.******** ******* 



*4i**B2*^*^^^*^* 

* * 

* ENTER VIA BAL ♦ 

* * 

«*«4i***4i******4. 



********»> 



♦SET UP TO WRITE* 

* VCB'S IN ♦ 

* REVERSE ORDER ♦ 

* * 

4i***«**4>«*#«4t4i**« 



♦ C3 ♦ >♦ WRITE VCB ♦ 

* ♦ ♦SEARCH FOR NEXT^ 
♦♦** ♦ HOLE * 



♦ RETURN VIA REG ■■ 
>* 14 



.♦ ANY ♦. 

♦. MORE VCB'S . 

♦.TO WRITE .♦ 



*****Dlt**«***4<**« 

* * **** 
♦SET UP CHAINING^ ♦ ♦ 

>♦ PTRS FOR NEXT ♦ >♦ C3 * 

♦ VCB * * * 



*«**«« 



**4f4****** 



El-*%.^ 


If t^1fif1i-£2*** ******* 

* * 


if 

*«4t*4:£3*****4t**** 
* * 


WRITENEW 


END OF ♦.NO 

EXTENT . ♦ 

.* 


♦SET ERROR CODE ♦ 
>* TO 28 ♦ 


♦PUT TTR OF 1ST * 

♦ VCB IN USER ♦ 

♦ AREA ♦ 


♦ 

♦ ENTER VIA BAL 



« 4141 *«*«**** * 



*P2.«*4<**4<** 



***** 

♦ 035* 

♦ m* 



***** 

*035* 
♦ H2^ 



.♦ WAS ♦. 

♦ EXTENSION ♦. NO 
SUCCESSFUL .♦ 



*G2********** 



4i4t**4<*4c««4<4>*#4>* 



4i4t*4<**4t«4.*4t« 



♦SEARCH FOR NEXT^ 
♦ AVAIL HOLE, ♦ 
♦EXTEND IF NONE ♦ 

*4i**i|i4i*4i4[4i«4i«4<4'** 



****HH********** 

* CONVERT * ♦ 
♦ADDR OF BLK^ ♦ 

* FOUND TO ♦ ♦ 

* TTR * ♦ 

* ♦ * 
**************** 



****J14*********: 



<!****#**«* 



^^,^i**^*t******* 
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CATALOG MANAGEMENT 
IGG0CLC3 



♦♦♦*A1********* 
♦ENTRY VIA XCTL • 

♦ FR IGG0CLC2 ♦-- 

♦ ♦ 



♦ Bl •—■ J 

****** I 



♦♦Bl********** 



A". 

* A2 * 

* ♦ 

AD3P1 



WAS GDG *. YES 

INDEX PTR .* 

. FOUND . * 



^i,***li3******»*** 



* INSTEAD OF 8 



B2 *. 

.♦COMPARE*. 
CALCULATE ♦NEW>OLD .*NEW NAME TO*. 

LENGTH OF OLD *< *. FOUND .* 

ENTRY ♦ ♦. NAME .* 

* *. .* 



**^2********** 



*****B4***4i4i4i**** 



*i|t«4i4i*4>4.*« 



**4i**4i****4t**** 



* * 

* 85 ♦ 
***• 

1 

* * 

*SET COMPLETION * 
>* SWITCH ON * 

* * 

4t * 



CI *. 

.*ROOM IN*. 
.*OUTPUT AREA*. YES 

♦. FOR OLD .♦ 

♦ . ENTRY . ♦ 



* Dl ♦-> 



t**E±************ 



«*«**««**«***4i 



♦♦♦*F1* *******♦♦ 



***************** 



***************** 



*****Q2** ****** 



********* 



* ENTRY, SUBTRACT *<- 
*FROM INPUT PTR * 



*********** 



E2 *. 

.*ROOM IN*. 

.♦OUTPUT AREA*. 

FOR NEW .♦ 

♦ . ENTRY . * 

'♦. .♦" 



*****Q2********** 

♦ ADD LENGTH OF * 
♦MOVED ENTRY TO ♦ 

♦ INPUT, OUTPUT ♦ 

♦ PTRS ♦ 



******** 



***** 



.♦ IS ♦.NO • 

*. COMPLETION .* >* A2 

♦ . SW ON .♦ ♦ 






.♦ MORE ♦. 
.♦ENTRIES IN *. YES 

INPUT .* 

♦. AREA .♦ 



*****j^2** ******** 

* * 
♦SET UP TO READ ♦ 
♦NEXT SEQUENTIAL+ 

♦ ELK ♦ 



.♦ IS NEXT ♦.NO * ♦ 

->«. ENTRY NAME .* >* Bl * 

*. X'FF* .* * .* 
*. .* *♦** 



IS TTR 

POINTER 

ZERO 



*****^t^**** 



**** 
K5 * 



***K5************ 
READ 
* INDICATED BLK * 

INTO INPUT i 

* AREA * 
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CATALO(. MANAGEMENT 
1UG0CLC3 



LASTBLK 

♦ SET KEY OF J 

♦ BLOCK TO BE * 
♦WRITTEN TO HEX J < 

FF , 

♦*♦♦***♦♦♦*♦♦»♦»; 



INDEX BLOCK 



***** 

♦ 039* 

♦ hi* 



****^A2*+^ *♦♦•♦♦♦ 

* ♦ 

* ZEPO THE TTR ♦ 

* POINTER IN ♦ 

* OUTPUT AREA ♦ 

* ♦ 
«■****** *j» ******** 



*****B2* ♦♦♦*♦♦♦♦♦ 



*********** 



.♦HAS BLK+. 

.♦BEEN FREED ♦. 

DURING 

♦.UPDATING .♦ 



.♦ IS ♦. 

.♦ MODIFIED ' 
. INDEX VOL 
♦ • INDEX . 



♦♦♦Fl************ 

♦ WRITE UPDATED ♦ 
INDEX CNTRL 
* BLK ♦ 
♦****»**#^^^^^^^^ 






♦ ♦*G1*******«**. 

♦ WRITE UPDATED 
« VOL INDEX 
♦ CNTRL BLK ♦ 
*»*»****»*^^^^^^^ 



♦****H1****** 



4. 4i4>«*£2^^ ♦♦♦♦♦♦♦♦ 

♦UPDATE INDEX 6 ♦ 

♦VOL INDEX CONTRA 

-♦ BLKS IF ♦ 

♦ NECESSARY ♦ 



41*41****4,414.4141 



i**** 



*****JI* ********* 

* ♦ FREEMAIN ♦ ♦ 

* ♦ FOR ALL ♦ ♦ 

* ♦ USED, DEQ ♦ ♦- 

* * ON All ♦ ♦ 

* ♦ RESOURCES ♦ ♦ 

***************** 



♦♦♦♦J2^^^^^+**^ 

♦ RETURN TO 
>♦ CALLER VIA SVC 

♦ 3 
*************** 
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CATALOG MANAGEMENT 
IG60CLC4 



4.*<»»***«*4>**«** 



* ENTRY ♦, NO 

FROM . ♦ 

*.IGG0CLC1 .♦ 



NAME IN 
RELATIVE 
. FORMAT 



.* IS 
->*. FUNCTION 
*. LOCATE 



♦OUl* 



NAME IN *. NO 

CORRECT . ♦ 

FORMAT . * 



* READ NAMED * 
ENTRY USING 
* BLDL * 

4> 4i * « * * * « * <[ ])( * 4t * 4> * * 



*«4.4.*4i4.4c*4<** 



♦ J2 ♦ 

* * 



*i,i,**EH********** 



.* WAS ♦. 

. BLDL ERROR . 
*.CODE ZERO.* 



1" 

* * 

♦ouo* 

* F3* 



* XCTL TO * 

* IGG0CLC5 * 

* * 



*^i*l.*t****** 



* * 

♦MOVE ENTRY DATA* 

* INTO USER'S *< 

* AREA * 

* * 



* READ VCB INTO ♦ 
USER'S AREA 
♦ USING BLDL * 



DEQUE V 

* * FREE MAIN * 

* *STORAGE AND* 

* * DEQUEUE * 

* * ♦ 



♦***K2** ****** 
* RETURN TO * 
♦CALLER VIA SVC * 

*****4<4>4i«****«* 



uo 



CATALOG MANAQININT 

xaaocLCO 



• * 

♦ CONVERT ♦ 

* RELATIVE GEN. * 

♦ NO. TO BINARY ♦ 

* * 
****** *«*«4i«*«*i»* 



NXTBLK 

READ A BLX OF 
• THE ♦ 
GENERATION 
• INDEX * 

***«**4. ****** **** 



* * 

* EXAMINE NAME * 
>♦ FIELD OF AN ♦ 

♦ENTRY IN INDEX * 

* ♦ 



IS IT 


♦.YES .♦ MORE 


8X*FF« 


.♦ >♦. BLOCKS IN 




.♦ ♦. INDEX 



♦.POSITIVE 



.♦GIVEN REL. ♦. 
♦. GEN. NO. 
♦.NEGATIVE .♦ 



♦ * 

♦ POINT TO NEXT ♦ 
♦ENTRY ADD 1 TO ♦ 

♦ REL. GEN. NO. ♦ 

♦ ♦ 
*4>i» 414141 *«***« *4i*4.« 



♦ MORE 

ENTRIES IN 
♦. BLOCK .' 



* 

♦COMPLEMENT GEN. 
->♦ NO. OF FOUND 
♦ ENTRY 

**************** 



.♦GIVEN REL. 

♦. GEN. NO 

♦ . ZERO 



****i»*4i4>4>**4'4'4>4>^^ 



4>4>4>**E3^^^^^^^^^ 

* 

♦ SET UP DUMMY 

♦ FOUND NAME OF 

♦ GOOOOVOO 
♦ 
**************** 



*****P2********* 

♦ADD GIVEN REL. 
-> ♦VALUE TO FOUND 
♦ GEN. NO. 



****q2********** 

* 

MOVE TOTAL TO ♦ 

USER AREA AS ♦ 

GEN. NAME ♦ 

* 

**************** 



***** 

♦ OUO^ 

♦ F3^ 



*4'4-4'* 

♦ 040^ 

♦ G2^ 



Appendix A: Flowcharts 41 



CATALOG MANAGEMENT 
IGGOCLCil 



EMPTY V 

• SET UP OUTPUT ♦ 
♦AREA WITH X'FF'* 
♦KEY, IND CNTRL * 
•ENTRY, NAME OF ♦ 

♦ NEW ENTRY * 



* * 

* MOVE INDEX ♦ 

* LINK ENTRY TO ♦ 

* OUTPUT AREA ♦ 



if^*C2************ 



*«**4[***4t4i ******* 

* * 

* D2 ♦-> 

***D2************ 

* WRITE ♦ 

CONTENTS OF 

* OUTPUT AREA ♦ 

***************** 



*****^2********** 
4> ♦ 

♦ SCAN FOR LAST * 

♦ ENTRY IN BLK * 

♦ JUST READ * 

♦ * 
********* ******* 



F2 ♦. 


*****P2********** 


.* DOES ♦. 


♦ INCREMENT TTR ♦ 


.♦NAME FIELD ♦. NO 


♦ TO NEXT ♦ 


CONTAIN . ♦ 


>♦ SEQUENTIAL *• 


♦. SX'FF* .♦ 


♦ BLOCK ♦ 



************ 



***QX************ 

♦ READ VOL ♦ 
INDEX USING <~ 
♦ BLDL ♦ 

***************** 



*****fl1********** 

♦ UPDATE VOL ♦ 

♦ INDEX CONTROL ♦ 

♦ BLK IF ♦ 

♦ NECESSARY ♦ 

♦ ♦ 
***************** 



CHAIN 

POINTER 

ZERO 



.♦. 


G3 ♦. 


.♦TTR OF ♦. 


.♦ OLD INDEX ♦. YES 
.LT 1ST AVAIL .♦ 


♦. HOLE .♦ 


♦. .♦ 


♦ . .♦ 


♦ NO 


**♦♦ 




* 




H3 ♦-> 





*****Qm********** 

♦ ♦ 

♦ UPDATE VOLUME ♦ 
>♦ INDEX CONTROL ♦ 

♦ BLOCK ♦ 



♦♦♦H3^^^^^^^^^^^^ 

♦ READ NEXT BLK ♦ 

IN CHAIN 

♦ USING BLDL ♦ 

***************** 



***Jl************ 

* ♦ 
REWRITE IT 

* * 

***************** 



*****j2********** 



***************** 



***** 

♦ OUO^ 

♦ J2^ 



*****J3********** 

* * 

* SET KEY OF ♦ 
♦OUTPUT AREA TO ♦ 

* ZEROS ♦ 

* * 
***************** 

I**** 
♦ ♦ 

->♦ D2 ♦ 

* ♦ 
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CATALOG MANAQBIMENT 
IGG0CLC5 



♦ENTRY VIA XCTL • 
* PROM IGG0CLC4 • 



A2 ♦. 

* *. 

IS 

REQUEST 

CATALOG 

♦. .♦ 

♦. .* 

♦ NO 



* WAS 

NAME FOUND 
♦. BY BLDL . 



.♦ ♦. 


4>«4>* 


.♦ MAS *. NO 


* * 


->*. NAME FOUND .♦ 


->♦ D3 ♦ 


♦. BY BLDL .♦ 


* * 


*. .♦ 


**** 



***4i*4i«4>4i**«**4i«* 



* * FREEMAIN ♦ * 

* ♦ FOR ALL ♦ * 
->♦ *USED DEQ ON* ♦- 

♦ ♦ ALL ♦ ♦ 

♦ ♦ RESOURCES * ♦ 



***4>B5 ********* 

♦ RETURN TO * 
->*CALLER VIA SVC * 

♦ 3 * 



*****«***4>*4i«4i* 



.♦ IS *. NO 

*. REQUEST TO .* 

♦.UNCATALOG.* 



* 

♦SUBTRACT 1 FROM' 

* GENERATION 

* COUNT 



***E2************ 



IHl *************** 



**** 

* 
D3 * 



*«*«4>d3********** 

* * 
♦SEARCH FOR NAME* 

* IGNORING *- 

* VERSION NO. * 

* * 
***************** 



— >♦. INDEX FULL 



INDEX l-UJjIi •• -i 

'■♦• ••■* 1 

*. .♦ V 



***** 
*0i»«»* 
♦ Al* 



YES .♦ WAS A ♦. 

♦. VCB POINTER .* 

*. FOUND .* 



*****^H*** ******* 



***************** 



****E5********* 

ADD 1 TO 

GENERATION 

COUNT 

*************** 



4i**F54i**4>«*«itr**** 



***************** 



♦ BUILD NEW ENTRY- 

♦ 

*******^i***1Hf*** 



♦BUILD NEW ENTRY* 

4> ♦ 

***************** 



***************** 



♦♦K2+^^^^^+*^ 
XCTL TO ♦ 
IGG0CLC3 ♦ 
♦ 
********^**** 
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CATALOG MANAGEMENT 
I660CLC5 



***** 

*oa«* 

• Al* 

* * 



♦. EMPTY SW ON .♦- 



* RESET • 
>♦ GENERATION ♦- 

* COUNT TO ONE ♦ 

* * 
«•««** ******* «**• 



***************** 



*****B1********** 



*****S2******** 



***************** 



***************** 



***************** 



.* NEW ♦. 
.*£NTRY OLDER*. YES 

♦. THAN .* 

*. OLDEST .* 



*****C3********** 
♦BLDENTRY 04aF2* 

♦BUILD NEW ENTRY* 
* ♦ 

***************** 



♦ SCRATCH ANY * 
*VCBS OF OLDEST * 

♦ ENTRY ♦ 
***************** 



**** *£!********** 



***************** 



***P1 ****** ****** 



***************** 



*0«»3* 
* H2* 

* * 



* ♦ DEQUEUE, 

* * frSemain 

* * FOR ALL 

* ♦ STORAGE 

* * USED 
****************; 



****E2********* 

* RETURN TO * 
* CALLER VIA SVC * 

♦ 3 * 
*************** 



BLDENTRY 

****F2** ******* 

* * 

* ENTER VIA BAL * 

* * 
*************** 



OVER 5 

VOLS IN 

.DATA SET 



****D3* ******** 

* XCTL TO * 

* IGGOCLCU TO * 

* EMPTY INDEX ♦ 
*************** 



REPETERE 

****E3********* 

* * 

* ENTER VIA BAL * 

* * 
*************** 



SCRINIT 

****D4* ******** 

* * 

* ENTER VIA BAL * 

* * 
*************** 



WAS VCB 

POINTER 

FOUND 



*****G3* ********* 

* * 

* EUILD * 
>* APPROPRIATE * 

♦NUMBER OF VCBS * 

* * 
***************** 



*****{]2* ********* 

* * 
♦BUILD NEW DATA ♦ 
*SET PTR OR VCB * 

♦ PTR ENTRY ♦ 

***************** 



♦***J2********* 

* * 

* RETURN VIA BR * 

* * 
*************** 



***************** 



***G'(*** ********* 

* FREE IT BY * 
WRITING A 
* ZERO KEY * 
***************** 



* SCRATCH DATA ♦ 

♦ SET IF REQ'D ♦ 

***************** 



SCRATCH 

****Q5********* 

* * 

* ENTER VIA BAL ♦ 

* * 
*************** 



.* WAS ♦. 

. ♦ SCRATCH * . 

OPTION 

*. SPECIFIED.* 



*****P5*** ******* 

* * * * 

* * SCRATCH * * 

* * DATA SET * * 

* *WITH SVC 29* * 

* * * * 
***************** 



****G5 ********* 

* * 

* RETURN VIA BR * 

* * 
*************** 



* IS *. 

THERE *. NO 

ANOTHER . * 

VCB .* 



****j5********* 

* * 
->* RETURN VIA BR * 

* * 
*************** 
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CATALOQ NANAaEMENT 
XGQ0CLC6 



IGG0CLC6 

♦ XCTL FROM ♦ 

• IGG0CLC2 ♦ 

* * 



NOTLOC 

♦ • PREEMAIN ♦ • 

♦ ♦ FOR INDEX ♦ ♦ 
>* ♦ CATALOG ♦ * 

WORK AREA 



* * 



* * 



41**41 4i*4i**4i4i*«**4i* 



4i4i***C14>********* 

* * * * 

* ♦ FREEMAIN • ♦ 

* ♦FOR LOCATE ♦ ♦- 

* ♦ WORK AREA ♦ ♦ 

* * * * 
************ •*4i** 



♦ ♦DEQUEUE ON ♦ ♦ 
->♦ ♦ SYSCTLG ♦ ♦ 

♦ * * ♦ 

♦ 41 ♦ ♦ 
*«*4>**4i**4>****^** 



♦ EXIT TO USER ♦ 

♦ VIA SVC 3 ♦ 

♦ * 
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CATAtOQ MANAQCMINI' 
IQCQ0Q2H 



XaC0002H 



'^.m*iu./ 



.•ENTRY XCTL ♦. YES 

FROM .♦ 

♦. EXTEND .♦ 



♦ ♦ FREEMAIN 

♦ ♦FOR EXTEND ♦ ♦ 
>♦ • WK ♦ *- 

♦ ♦ AREAS-OLD * * 

♦ •DCB AND DEB* • 
***************** 



.♦. 




EXTEND 








CI *. 






***i 


*C2********** 


♦ WHAT ♦ 








* 




* 




FUNCTION 


♦ . 


EXTEND 




♦GETMAIN FOR* 




WAS 


.♦ 




->* 


* 


EXTEND 


* 




REQUESTED 


4> 






* 


MODULES 


♦ 





***************** 



*****^2********** 

* * * * 

* *GETMAIN FOR* * 
->* * NEW DCB, * * — 

* * DEB * * 

* * * * 
***************** 



*****Q2********** 

* SET SW TO ♦ 

* INDICATE 1ST * 
>*PASS OF EXTEND * 

* FUNCTION * 

* ♦ 



*****'QH********** 

* SET SW TO * 

* INDICATE 2ND ^ 
->*PASS OF EXTEND *— 

* FUNCTION * 

***************** 



* BUILD DEB AND * 
*DCB FOR ENTIRE * 

* VOLUME ♦ 

* * 
***************** 



*****El********** 

* * 

♦ BUILD lOB AND * 



***************** 



***p-l************ 
SEARCH AND 
* READ DSCB FOR ♦ 
SYSCTLG DATA 
* SET * 

***************** 



WAS 
DATA SET 
. FOUND 



>♦ 



**** 

* 
*SET ERROR CODE ♦ 



***************** 



***G3********** 

* * * 

* FREE ALL ♦ * 

* MAIN ♦ *- 

* STORAGE * ♦ 



****QH********* 

RETURN TO * 
CALLER ♦ 



1ST OR ♦ 
2ND PASS OF 
. EXTEND .* 



* SECONDARY 
ALLOC. QTY 
* . ZERO 



. * MUST ♦ . 
. DATA SET BE . 
♦.FORMATTED.* 



*4^*************** 



*****Yi3********** 

* * 

* CONSTRUCT A * 
->*DUMMY JFCB FOR *- 

* DADSM * 

* * 
***************** 



*****j2********** 



***************** 



♦ ***H'*******» 
♦BUILD lOB, DCE, 



->* DEB CHAIN ♦ >♦ 



***************** 



ja 



♦♦H5^^^^^^^^^ 
XCTL TO ♦ 
IGG0533A ♦ 

*************** 



IS ♦. 

.♦ THERE A ♦, NO 

->♦. LINK TO A .♦ X 

♦.FORMAT 3 .* V 

♦.DSCB .♦ ♦♦*♦* 

♦ . .♦ ♦0'»7^ 

♦ YES ♦ Al^ 

* * 



************** 



***i^H************ 
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CATALOG MANAGEMENT 
IGC0002H 



♦047* 
♦ Al* 



♦ ♦ FREEMAIN ♦ ♦ 

♦ ♦FOR UNUSED ♦ ♦ 

♦ ♦ DEB.DCB 

♦ * — ' — 

♦ * 
***************** 



SPACE 



.♦ IS 
FORMAT 
♦.SWITCH ON.' 



*****B2^^ ♦♦♦♦♦♦♦' 

* * * 

♦ ♦GETMAIN FOR^ 
>♦ ♦ FORMAT ♦ 

♦ ♦ ROUTINE ♦ 

* * » 
**************** 



t****B3********** 
♦ SET UP DCE ♦ 
♦ADDR, INDICATE ♦ 

>♦ ROUEST IS TO ♦ 

♦FORMAT CATALOG ♦ 



********* 



******* 



****B4********* 

♦ XCTL TO ♦ 

♦ IGG0CLF2 ♦ 

♦ ♦ 
*************** 



*****ci********** 



***************** 



*****D1* ******** 



**************** 



♦♦♦♦£!♦♦♦♦♦♦♦♦♦ 

♦ RETURN TO ♦ 

♦ CALLER ♦ 

♦ * 

******«******;»« 
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CATALOG MANAGEMENT 
IGG0CLF2 



****A1**'******* 
♦ENTRY VIA XCTL ♦ 

♦ FRCM IGC0002H ♦ 

* * 
*4>«4>* ********** 



4t***«A2** ******** 

* * 

* BUILD ECB AND * 
>* JOB, RELOCATE • 

* THEM * 

* * 
***************** 



.*REQUEST TO *. NO 

. FORMAT BPAM .* 

*. DIRECTORY.* 



*****C2********* 

* INIT TO START 
*AT BEGINING OF 
*DIR. AND ALLOW 

* FOR FOD MARK 

**************** 



CTLGFMT .*. 

B3 *. 

.*HAS END*. 

.* OP EXTENT *. 

•*. BEEN . * 

*. REACHED .* 



CTLOOPl 

***BH**** 
WRITE FULL 
* TRK OF 

> FORMATTED 

* BLOCKS 



******** I 

•ULL 

IF ♦ 

TED J 



***************** 



*****C3********** 

* GO BACK 1 TRK * 
*T0 PASS LAST TT* 

* IN CAT/iLOG TO * 

* CALLER * 

* * 
***************** 



*****P2********** 
*SET UP 1ST CCW * 

♦ TO WRITE * 
*SPECIAL BLK FOR* 
* EMPTY DIRECTORY* 

* ♦ 
***************** 



*****^2***'*'***** 

* BUILD VOLUME 

* INDEX CONTROL 

* BLOCK 
* 
***************i 



***p2* *********** 
WRITE IT 



********* 



* HAS *. NO 

LAST RECORD .* 

♦.BEEN WRTN.* 



*****^2** ******** 

* * 
♦SET UP CHANNEL ♦ 

* PROG TO WRITE * 

* EOD MARK ♦ 






WRITE 

SPECIFIED 

HECORDS 



********* 



'***H3********** 



**************** 



***J3************ 



*********** 



EXTENDED 

*****JH*** ******* 

♦PUT LAST TT IN * 

' ♦DATA SET IN REG^ 

— >♦ TO RETN TO ♦ 

♦ CALLER ♦ 

***************** 



.* HAVE *. 

.♦ALL RECORDS^. 

BEEN 

♦. WRITTEN .♦ 



*****j^3* ********* 



*************** 



#«*4i*Ki| ♦******♦♦♦ 

* ♦ ♦ * 

* ♦ FREEMAIN ♦ ♦ 
->♦ ♦PROVIDED BY^ ♦- 

♦ ♦ IGC000 2H ♦ ♦ 

♦ ♦ * * 
***************** 



****j{^********* 
♦ RETURN TC 
->^CALLER VIA SVC 
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APPENDIX B; OLD CVOL POINTER 



Before Release 11, the control volume pointer entry had no device 
type code field. Since some control volumes may still contain the old 
entry, and since the routines still check for it, its format is given 
here. 





Field 1: 




Field 2: 


03 




Field 4: 






Name 




Zeros 






Control Volume 
Serial Number 









7 8 10 11 


12 




17 








lo Dyres 
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APPENDIX C: DEVICE TYPE FIELD 



The device code portion of Data Set Pointer Entries, Vol\ame Control 
Blocks, and Control Volume Pointer Entries is identical to the UCBTYP 
field of the Unit Control Block, This description is included here for 
easy reference • 



lOS 
Flags 


Model 
Code 


Optional Features 


Device Class 


Unit Type 



Byte 1 



Byte 2 



Byte 3 



Byte 4 



For a complete description of the fields shown above, please refer to 
IBM System/360 Operating System System Control Blocks , Form C28-6628. A 
brief description of some of the fields appears below. 



Device class: (Byte 3; values are in hex) 

X'80' Magnetic Tape 

X'20' Direct Access 

X'08' Unit Record 

X'lO' Graphics 

X • U • Communications 



When Byte 3 indicates direct access, byte 
device as follows: 



4 indicates the specific 



X'Ol' 2311 Disk Storage Drive 

X'02' 2301 Parallel Driim 

X'03' 2303 Serial Drum 

X«04« 2302 Disk Storage 

X'05' 2321 Data Cell Drive 

X'08' 2314 Disk Storage Facility 
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imm. 



Where more than one page reference is 
given, the major reference is first. 

abiDreviations of routine names 3 
abnormal termination 10 
absolute generation number 

obtained from relative gen. no. 16,11 

reference to catalog using 1 
address 

fields of catalog entries (see 
description of specific entry) 

of UCB as a parameter 12,17 

of lECPBLDL 13 
alias entries 

count of, in index control entry 20 

creating 11 

deleting 12 

description of 
detailed 22-24 
general 9 
allocated space for SYSCTLG 12,17 
allocation quantity, secondary 12,17 
assembler language code 19 

BALR instruction as linkage 13 

BLDA function 11 

BLDG function 11 

BLDL routine (lECPBLDL) 

linkage to 13 

treatment of keys by 4 

used to search for name 

by locate generations 10,16 
by normal locate 10,13 
BLDX function 11,3 
blocksize of SYSCTLG 4 

calculation of absolute generation 

numbers 16 
calling 

of catalog management routines 2 

parameters passed 26 

of CVOL routines 12,10 

of lECPLDL 13 
CAML3T macro instruction 25-26 
CATALOG macro instruction 2 
catalog function 11 
CATLG sub-parameter on DD card 2 
chaining 

of physical blocks 6 

of volume control blocks 23 
channel programs 

to format catalog 17 

to read and write blocks 13 
communication vector table (CVT) 13 
complement form of generation number 16,11 
connecting control volum.es 1-3 
count field 

of physical blocks U 

of catalog entries 20-24 
CSECT names of routi es 19 
CTLG parameter 26 
CVOL (control volume) 



description 1 
old pointer entry 50 
pointer entry 9,23 
routines 12,17 
CVT (see communication vector table) 



DADSM routines 17,11 

DCB (data control block) for SYSCTLG 17,12 

DEB (data extent block) for SYSCTLG 17,12 

delete option 17,26 

DEQ macro instruction 11,15 

device type field 49 

directory of a partitioned data set 17,12 

disconnecting control volumes 12 

DISP parameter of DD card 2 

DLTA function 12 

DLTX function 12 

DRPX function 12 

DSC3 (data set control block) 

format switch in 17,12 

information from 17 

representation of generation nos. 
in 16 

secondary allocation quantity in 17 
dummy generation number 16 



empty option 17,26 

ENQ macro instruction 10,13 

EXCP macro instruction 

initialization for 10 

use of 13 
extend routine 

catalog 12 

DADSM 17 
extending SYSCTLG data set 12,17 

flags 

in user's parameter list 2 6,2 

in generation index pointer entry 24,9 

flowcharts 30-47 

format switch in SYSCTLG DSCB 17,12 

formatting routine 17,12 

free blocks 12 

fully-qualified name 1 

functions of routines-chart 3 

GDG (generation data group) 1,11 
generation index 

building (see BLDG function) 

deleting (see DLTX function) 

inserting entries into 16-17 

locating entries in 16 

locating entries in 16 

pointer entry 9,24 

order of entries in 16 
GETMAliM macro instruction 10,13 
GOOOOVOO (see dummy generation number) 

high-level name 11 
housekeeping functions 13,10 



Index 51 



lECPBLDL 
lEHPROGM 
IGC0002F 
IGC0002H 



13 

2 

13 

17 



IGC026 19 

IGC028 19 

IGGOCLCl 13 

IGG0CLC2 

IGG0CLC3 

IGG0CLC4 

IGG0CLC5 

IGG0CLC6 

IGG0CLF2 

IGG0533A 



15 
15 

16 

16-17 
15 
17 
17 

index control entry 2 0,9 
index, generation (see generation index) 
index levels 4 
index link entry 2 
index, normal 

building (see BLDX function) 
deleting (see DLTX function) 
entry type 8-9 
inserting entries into (see catalog 

function) 
pointer entry 2 0,9 
removing entries from (see UNCAT 

function) 
structure 5 
initialization 

of new catalogs 17 
of processing 13 
input to the routines 25 

job scheduler 2 

keys 

description 4 

initialization of 12,17 

use of 12 
levels of qualification U-6,1 
link fields (see index link entry and 

volume control block) 
LINKX function 11 
locate function 

description 10,13 

output from 14 
logical organization of the catalog 

(figure) 4,6 
macro instructions 

CkMLST 2 5 

CATALOG 2 

IixIDEX 2 

LOCATE 2 
modules of the routines 13,14 (see also 

specific module names) 
multiprocessing environm.ent 10 
multiprogramming environment 10,13 

NJ^ME parameter 26 

open routine 12,17 

options (see empty option, delete option) 

order of entries 

in generation indexes 16 

in normal indexes 4 



parameters passed to routines 26 

partitioned data set (PDs) directory 
formatting of 17,12 
similarity of catalog to 4 

physical organization of catalog 4 

pointer entries 20-24 



qualifiers 1 



13 



reading the catalog 

RECAT function 11 

records (see physical organization) 

reenterable routines 10,13 

region 10 

register usage (chart) 28-29 

relative generation number 

in calculating absolute 16 

validites of 1 
RESERVE macro instruction 10 

scratch routine 17 
searching the catalog 10 
secondary allocation quantity 17 
sequence of entries in catalog (see order 

of entries) 
serial number, volume (see volume serial 

number ) 

simple names 4 
supervisor calls (SVCs) 



SVC 19 


10 


SVC 26 


2,13 


SVC 28 


17,10,13 


SVC 29 


11,17 


SYSCTLG 




as name 


for ENQ/DEQ 



13 
data set 

allocation of space for 
definition of 1 
extending 17 
formatting 17-18 
opening 17 
SYSl.SVCLIB 19 



12 



unit control block (UCE) 
device type field of 
of control volxime 
as parameter 12,17 
searching for 13 
UNCAT function 11 
user's parameter list 26 
utility programs 2 
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9,23 



volume control block (VCB) 
volume serial number 

of cataloged data set 5,9 (see also 
volume control blocks and data set 
pointer entry) 
of control volume 13 
volume table of contents (VTOC) 12,17 

writing in the catalog 13 

XCTL macro instruction 13,17 
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READER'S COMMENT FORM 



IBM System/36 Operating System 
Catalog Management 
Program Logic Manual 



Form Y28-6606--1 



Your comments, accompanied by answers to the following questions, help us produce better 
publications for your use. If your answer to a question is "No" or requires qualification, 
please explain in the space provided below. Comments and suggestions become the property of 

IBM. 



• Does this publication meet your needs? 

• Did you find the material: 

Easy to read and understand? 

Organized for convenient use? 

Complete? 

Well illustrated? 

Written for your technical level? 



Yes 


No 


D 


D 


D 


D 


D 


D 


D 


D 


D 


D 


D 


D 



• What is your occupation? 

• How do you use this publication? 



As an introduction to the subject? Q 

For advanced knowledge of the subject? □ 

For information about operating procedures? □ 



As an instructor in a class? □ 
As a student in a class? □ 

As a reference manual? □ 



Other 



• Please give specific page and line references with your comments when appropriate. 



COMMENTS 



Thank you for your cooperation. No postage necessary if mailed in the U.S.A. 



Y28-6606-1 



YOUR COMMENTS, PLEASE... 



This publication is one of a series which serves as reference sources for systems analysts, 
programmers and operators of IBM systems. Your answers to the questions on the back of 
this form together with your comments, will help us produce better publications for your 
use. Each reply will be carefully reviewed by the persons responsible for writing and pub- 
lishing this material. All comments and suggestions become the property of IBM. 

Please note: Requests for copies of publications and for assistance in utilizing your IBM 
system should be directed to your IBM representative or to the IBM sales office serving 
your locality. 
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